在云服务器上用 Docker 部署 OpenList:从安装到 Nginx 反向代理与 HTTPS 的完整实践

简介: 本文详解如何在Debian云服务器上用Docker部署OpenList网盘索引服务:涵盖Docker Compose配置、Nginx反向代理、HTTPS自动签发(Certbot),并强调三大关键细节——端口仅限本地监听、避免外部刷新令牌、提前验证证书续期,全程零代码修改,安全可靠。(239字)

在云服务器上用 Docker 部署 OpenList:从安装到 Nginx 反向代理与 HTTPS 的完整实践

一、为什么要自建网盘索引服务

把多个网盘、对象存储和本地目录统一挂到一个 Web 入口,是很多个人开发者管理文件的常见需求。OpenList 是一个支持多存储聚合的文件列表程序:它本身不存文件,只负责把不同存储的目录结构统一展示出来,并提供预览、下载、WebDAV 等能力。

本文记录一次完整的部署过程:一台 2 核 2G 的 Linux 云服务器(Debian 12),用 Docker 运行 OpenList,再用 Nginx 做反向代理并签发 HTTPS 证书。整个过程不需要改任何业务代码,适合第一次在云服务器上部署自托管服务的同学参考。

二、准备工作

  • 一台已开放 80、443 端口的云服务器,安全组中放行这两个端口
  • 一个解析到该服务器公网 IP 的域名,例如 pan.example.com
  • 已安装 Docker 与 Docker Compose

先确认 Docker 正常:docker version 和 docker compose version。

三、用 Docker Compose 启动 OpenList

新建目录并写入 docker-compose.yml:

services:
  openlist:
    image: openlistteam/openlist:latest
    container_name: openlist
    restart: unless-stopped
    ports:
      - "127.0.0.1:5244:5244"
    volumes:
      - ./data:/opt/openlist/data
    environment:
      - TZ=Asia/Shanghai
      - UMASK=022

注意端口映射前面加了 127.0.0.1:,表示服务只监听本机回环地址,不直接暴露到公网,后续所有外部访问都走 Nginx。这一条是很容易被忽略的安全细节:管理类服务尽量不要裸奔在公网端口上。

启动:mkdir -p openlist && cd openlist,然后 docker compose up -d,再用 docker compose logs -f --tail=50 查看日志。首次启动时日志里会输出初始管理员密码,务必保存下来,登录后第一时间修改。如果错过了,可以执行 docker exec -it openlist ./openlist admin random 重置。

四、添加存储时的三个坑

  1. 令牌不要在 OpenList 之外手动刷新。很多网盘的 refresh_token 是轮换制的:一旦你在别处用同一个 refresh_token 换了新令牌,OpenList 里保存的旧令牌就会失效,存储会突然掉线。需要新令牌时,让 OpenList 自己刷新,再从它的数据库里读取结果,不要在外部脚本里抢刷。
  2. 挂载路径要规划好。建议按用途划分一级目录,例如 /音乐、/影视、/备份,后续做权限控制和分享时更清晰。
  3. 驱动参数填错先看状态码。存储添加后显示异常时,先看驱动返回的错误信息,多数是回调地址、令牌范围或目录 ID 填错,逐项对照官方文档排查比反复重装有效得多。

五、Nginx 反向代理配置

新建站点配置 /etc/nginx/sites-available/openlist:

server {
   
    listen 80;
    server_name pan.example.com;
    client_max_body_size 0;
    location / {
   
        proxy_pass http://127.0.0.1:5244;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

几个关键点:client_max_body_size 0; 不限制上传体积,否则大文件上传会在 Nginx 这一层被截断;WebSocket 相关的两行不能少,否则部分实时功能会连接失败;X-Forwarded-Proto 要透传,后端生成下载直链时才不会把 https 写成 http。

启用并重载:ln -s /etc/nginx/sites-available/openlist /etc/nginx/sites-enabled/ 然后 nginx -t && systemctl reload nginx。

六、签发 HTTPS 证书

用 Certbot 一条命令完成签发和自动改写配置:apt install -y certbot python3-certbot-nginx,然后 certbot --nginx -d pan.example.com。Certbot 会自动配置 443 监听和 HTTP 跳转,并写入定时续期任务。可以用 certbot renew --dry-run 验证自动续期是否正常,这一步建议部署当天就做,不要等证书快过期了才发现续期是坏的。

七、上线后的检查清单

  • 管理员密码已修改,初始密码不再可用
  • OpenList 端口只监听 127.0.0.1,公网只能通过域名访问
  • HTTPS 正常,HTTP 自动跳转
  • 大文件上传、下载各测一次
  • ./data 目录纳入定期备份(里面是配置和存储令牌,丢了要全部重配)
  • 容器设置了 restart: unless-stopped,服务器重启后能自启

八、小结

这次部署真正花时间的不是命令本身,而是三个容易踩的细节:端口只监听本机、令牌不在外部抢刷、证书续期提前验证。把这三点处理好,一个自托管网盘入口就可以长期稳定运行,后续迁移服务器时也只需要搬运 docker-compose.yml 和 data 目录即可。

相关文章
|
6天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
7824 19
|
6天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2510 12
|
1天前
|
人工智能 安全 应用服务中间件
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
NGINX曝出两个高危漏洞(CVE-2026-123633和CVE-2026-123007),CVSS 9.2分,均属HTTP/2内存安全缺陷,无需认证即可远程执行代码。影响自2015年起的多个版本,静态站点亦受威胁。修复版本为开源版1.30.7/1.31.9。(239字)
1228 0
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
|
4天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
9天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
9天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
21天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
10602 59
|
5天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1146 1
|
7天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。

热门文章

最新文章