在 Windows 上部署 Sub2API,需要配置 Docker Desktop、PostgreSQL、Redis、端口映射和管理员账号。为了省去重复操作,我整理了一套本地一键部署脚本。
一键脚本下载地址:https://pan.ailxw.com/pickup?code=01120
GitHub项目地址:https://github.com/Wei-Shaw/sub2api/tree/v0.2.4
功能
脚本可以自动完成:
检测 Docker Desktop 是否安装
检查并升级到官方最新版
自动下载和安装 Docker Desktop
启动 Docker 引擎并等待就绪
拉取 Sub2API、PostgreSQL 和 Redis 镜像
初始化数据库和 Redis
创建管理员账号
修复 Docker 凭据助手异常
查看日志、停止和重启服务
下载 Docker Desktop 时会显示进度、速度和预计剩余时间,并支持直连与本地代理切换。
使用方法
将部署文件放在以下目录:C:\Users\small\sub2api-local
双击运行:一键部署与管理.bat
然后选择:1. 全自动部署并启动
首次安装 Docker Desktop 时,Windows 会弹出管理员权限确认,点击“是”即可。
后台地址
部署完成后访问:http://localhost:18080
管理员账号:admin@sub2api.local
管理员密码:Sub2Api@2026!
首次登录后建议立即修改默认密码。
下载代理
如果直连 Docker 官方服务器速度较慢,可以在脚本菜单中选择:6. 切换 Docker Desktop 下载代理
启用后使用本地 HTTP 代理:http://127.0.0.1:10808
也可以先选择“测试下载代理连通性”,确认代理可用后再开始部署。
数据保存
PostgreSQL、Redis 和 Sub2API 的持久化数据保存在项目的 data 目录中。
停止或重建容器不会删除业务数据。不要随意删除 data 目录,否则可能丢失账号和配置。
注意事项
Windows 需要支持 WSL 2 和硬件虚拟化
确保端口 18080 没有被其他程序占用
Docker Desktop 首次启动可能需要等待一两分钟
正式使用前请修改管理员密码
公网部署还需要配置 HTTPS、防火墙和数据备份
这套脚本适合 Windows 本地测试和个人使用,可以减少 Docker 环境配置与 Sub2API 初始化过程中的常见问题。