From e732e9564e909b987ec52a045245a0907f9cbcce Mon Sep 17 00:00:00 2001
From: VIOLET <esqaNN@163.com>
Date: Sun, 26 Jul 2026 16:28:05 +0800
Subject: [PATCH] docs: add Windows Docker Desktop deployment guide (#9339)

* docs: add Windows Docker Desktop deployment guide

* docs: improve Windows Docker Desktop deployment guide

- 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

* docs: fix incorrect docker run commands in Windows Docker Desktop examples
---
 docs/en/deploy/astrbot/docker.md | 35 ++++++++++++++++++++++++++++++
 docs/zh/deploy/astrbot/docker.md | 37 ++++++++++++++++++++++++++++++++
 2 files changed, 72 insertions(+)

diff --git a/docs/en/deploy/astrbot/docker.md b/docs/en/deploy/astrbot/docker.md
index e4a347214..5b3d6a117 100644
--- a/docs/en/deploy/astrbot/docker.md
+++ b/docs/en/deploy/astrbot/docker.md
@@ -75,6 +75,41 @@ View AstrBot logs with the following command:
 sudo docker logs -f astrbot
 ```
 
+
+## Deploy via Docker Desktop on Windows
+
+### For Windows CMD
+
+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 soulter/astrbot:latest
+```
+> [!TIP]
+> If your network environment is in mainland China, the above command will not pull properly. Please use the following command to pull the image:
+>
+> ```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
+> ```
+>
+> (Thanks to DaoCloud ❤️)
+
+### For PowerShell
+
+Set `TZ` to the standard IANA time zone format (Region/City). Use `Asia/Shanghai` for China.
+
+```powershell
+docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "${PWD}\data:/AstrBot/data" --name astrbot soulter/astrbot:latest
+```
+> [!TIP]
+> If your network environment is in mainland China, the above command will not pull properly. Please use the following command to pull the image:
+>
+> ```powershell
+> 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
+> ```
+>
+> (Thanks to DaoCloud ❤️)
+
 ## 🎉 All Done
 
 If everything goes well, you will see logs printed by AstrBot.
diff --git a/docs/zh/deploy/astrbot/docker.md b/docs/zh/deploy/astrbot/docker.md
index 8eb911d75..daf616aa0 100644
--- a/docs/zh/deploy/astrbot/docker.md
+++ b/docs/zh/deploy/astrbot/docker.md
@@ -89,6 +89,43 @@ Windows 同步 Host Time（需要WSL2）
 sudo docker logs -f astrbot
 ```
 
+## 通过 Windows Docker Desktop 部署
+
+### 使用`Windows CMD`
+
+`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 soulter/astrbot:latest
+```
+> [!TIP]
+> 如果您的网络环境在中国大陆境内，上述命令将无法正常拉取。请使用以下命令拉取镜像：
+>
+> ```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
+> ```
+>
+> (感谢 DaoCloud ❤️)
+> 
+### 使用`PowerShell`
+
+`TZ` 的值请设置为 **IANA 时区标准格式**（地区/城市），例如中国为 `Asia/Shanghai`
+
+```powershell
+docker run -itd -p 6185:6185 -p 6199:6199 -e TZ=Asia/Shanghai -v "${PWD}\data:/AstrBot/data" --name astrbot soulter/astrbot:latest
+```
+> [!TIP]
+> 如果您的网络环境在中国大陆境内，上述命令将无法正常拉取。请使用以下命令拉取镜像：
+>
+> ```powershell
+> 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
+> ```
+>
+> (感谢 DaoCloud ❤️)
+> 
+
+
+
 ## 🎉 大功告成
 
 如果一切顺利，你会看到 AstrBot 打印出的日志。