docs: add Windows Docker Desktop deployment guide#9339
Conversation
dosubot
Bot
added
the
size:M
![sourcery-ai[bot]](https://avatars.githubusercontent.com/in/48477?s=60&v=4){kind=small}
There was a problem hiding this comment.
Pull request overview
Adds Windows-specific Docker Desktop deployment instructions to the AstrBot Docker guides, helping Windows users run the container from both CMD and PowerShell with correct volume mounting and time zone configuration.
Changes:
- Added a “Docker Desktop on Windows” section to the Chinese deployment guide with CMD/PowerShell examples and IANA
TZguidance. - Added the equivalent “Docker Desktop on Windows” section to the English deployment guide.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| docs/zh/deploy/astrbot/docker.md | Adds Windows Docker Desktop deployment section with CMD/PowerShell commands and TZ notes. |
| docs/en/deploy/astrbot/docker.md | Adds English Windows Docker Desktop deployment section with CMD/PowerShell commands and TZ notes. |
| sudo docker logs -f astrbot | ||
| ``` | ||
|
|
||
| ## 通过Windows Docker Desktop部署 |
|
|
||
| `TZ` 的值请设置为 **IANA 时区标准格式**（地区/城市），例如中国为 `Asia/Shanghai` | ||
|
|
||
| ```bash |
|
|
||
| Set `TZ` to the standard IANA time zone format (Region/City). Use `Asia/Shanghai` for China. | ||
|
|
||
| ```bash |
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request adds documentation for deploying AstrBot via Docker Desktop on Windows using CMD and PowerShell in both English and Chinese. The reviewer suggested using the official Docker Hub image (soulter/astrbot:latest) by default instead of the DaoCloud mirror, and recommended using Windows-style backslashes (\) for local volume paths to ensure compatibility and prevent potential path resolution issues.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| Set `TZ` to the standard IANA time zone format (Region/City). Use `Asia/Shanghai` for China. | ||
|
|
||
| ```bash | ||
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "%cd%/data:/AstrBot/data" --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest |
There was a problem hiding this comment.
在英文文档中，默认应该使用官方的 Docker Hub 镜像 soulter/astrbot:latest，而不是国内的 DaoCloud 镜像源。此外，在 Windows CMD 环境下，本地路径建议使用反斜杠 \（即 %cd%\data）以符合 Windows 的路径规范，避免部分环境下出现路径解析问题。
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "%cd%/data:/AstrBot/data" --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest | |
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "%cd%\data:/AstrBot/data" --name astrbot soulter/astrbot:latest |
| Set `TZ` to the standard IANA time zone format (Region/City). Use `Asia/Shanghai` for China. | ||
|
|
||
| ```bash | ||
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "${PWD}/data:/AstrBot/data" --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest |
There was a problem hiding this comment.
在英文文档中，默认应该使用官方的 Docker Hub 镜像 soulter/astrbot:latest，而不是国内的 DaoCloud 镜像源。此外，在 Windows PowerShell 环境下，本地路径建议使用反斜杠 \（即 ${PWD}\data）以符合 Windows 的路径规范，避免部分环境下出现路径解析问题。
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "${PWD}/data:/AstrBot/data" --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest | |
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "${PWD}\data:/AstrBot/data" --name astrbot soulter/astrbot:latest |
| `TZ` 的值请设置为 **IANA 时区标准格式**（地区/城市），例如中国为 `Asia/Shanghai` | ||
|
|
||
| ```bash | ||
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "%cd%/data:/AstrBot/data" --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest |
There was a problem hiding this comment.
建议在此处默认使用官方镜像 soulter/astrbot:latest，以保持与文档前文（第 65 行）的一致性。如果用户在中国大陆境内，可以参考前文的提示自行替换为 DaoCloud 镜像源。此外，在 Windows CMD 环境下，本地路径建议使用反斜杠 \（即 %cd%\data）以符合 Windows 的路径规范。
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "%cd%/data:/AstrBot/data" --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest | |
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "%cd%\data:/AstrBot/data" --name astrbot soulter/astrbot:latest |
| `TZ` 的值请设置为 **IANA 时区标准格式**（地区/城市），例如中国为 `Asia/Shanghai` | ||
|
|
||
| ```bash | ||
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "${PWD}/data:/AstrBot/data" --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest |
There was a problem hiding this comment.
建议在此处默认使用官方镜像 soulter/astrbot:latest，以保持与文档前文（第 65 行）的一致性。如果用户在中国大陆境内，可以参考前文的提示自行替换为 DaoCloud 镜像源。此外，在 Windows PowerShell 环境下，本地路径建议使用反斜杠 \（即 ${PWD}\data）以符合 Windows 的路径规范。
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "${PWD}/data:/AstrBot/data" --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest | |
| docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "${PWD}\data:/AstrBot/data" --name astrbot soulter/astrbot:latest |
- Change default image to official registry (soulter/astrbot:latest) - Move DaoCloud mirror to TIP section - Update PowerShell code block language tag to powershell - Synchronize Chinese and English versions
完善 Windows 用户的 Docker 部署文档，提供 Windows CMD 和 PowerShell 两种环境下的具体部署命令，解决 Windows 用户在部署时遇到的路径和环境变量配置问题。
Modifications / 改动点
在 docs/zh/deploy/astrbot/docker.md 中新增"通过 Windows Docker Desktop 部署"章节
在 docs/en/deploy/astrbot/docker.md 中同步添加英文版本
This is NOT a breaking change. / 这不是一个破坏性变更。
Screenshots or Test Results / 运行截图或测试结果
Checklist / 检查清单
😊 If there are new features added in the PR, I have discussed it with the authors through issues/emails, etc.
/ 如果 PR 中有新加入的功能，已经通过 Issue / 邮件等方式和作者讨论过。
👀 My changes have been well-tested, and "Verification Steps" and "Screenshots" have been provided above.
/ 我的更改经过了良好的测试，并已在上方提供了“验证步骤”和“运行截图”。
🤓 I have ensured that no new dependencies are introduced, OR if new dependencies are introduced, they have been added to the appropriate locations in
requirements.txtandpyproject.toml./ 我确保没有引入新依赖库，或者引入了新依赖库的同时将其添加到
requirements.txt和pyproject.toml文件相应位置。😮 My changes do not introduce malicious code.
/ 我的更改没有引入恶意代码。
Summary by Sourcery
Document Docker Desktop deployment on Windows for AstrBot, covering both CMD and PowerShell usage with correct time zone and data volume configuration.
Documentation: