> ## Content Index
> Fetch the complete content index at: https://isoziyuan.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Windows 一键部署 Sub2API脚本：自动安装 Docker 并完成初始化
- URL: https://isoziyuan.com/p/100138/
- Published: 2026-09-10T04:24:45.000Z
- Updated: 2026-09-16T13:07:52.000Z
- Author: Isoziyuan

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

一键脚本下载地址：[https://pan.ailxw.com/pickup?code=01120](https://pan.ailxw.com/pickup/01120?ref=isoziyuan.com)

GitHub项目地址：[https://github.com/Wei-Shaw/sub2api/tree/v0.2.4](https://github.com/Wei-Shaw/sub2api/tree/v0.2.4?ref=isoziyuan.com)

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