Windows 一键部署 Sub2API脚本：自动安装 Docker 并完成初始化

在 Windows 上部署 Sub2API，需要配置 Docker Desktop、PostgreSQL、Redis、端口映射和管理员账号。为了省去重复操作，我整理了一套本地一键部署脚本。

一键脚本下载地址：https://pan.ailxw.com/pickup?code=01120

GitHub项目地址：https://github.com/Wei-Shaw/sub2api/tree/v0.2.4

VPS一键安装脚本

功能

脚本可以自动完成：

• 检测 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 初始化过程中的常见问题。