From ee5b0d36c663e6765a63f0c1ea2fcf52c25d2e83 Mon Sep 17 00:00:00 2001
From: saopig1 <saopig@duck.com>
Date: Mon, 30 Mar 2026 13:23:26 +0800
Subject: [PATCH] docs: expand Docker deployment section with commands and
 network notes

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 README.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 40c2a04..d1ea54d 100644
--- a/README.md
+++ b/README.md
@@ -79,7 +79,9 @@ sudo ./scripts/install.sh
 
 自动安装 Node.js、依赖，配置 systemd 服务，开机自启。
 
-### Docker 部署
+### Docker 一键部署
+
+所有依赖已内置（Node.js、FFmpeg、Opus 编码器），无需安装任何额外软件。
 
 ```bash
 cd scripts/docker
@@ -88,6 +90,29 @@ docker-compose up -d
 
 访问 http://localhost:3000
 
+**说明：**
+- 首次构建需要几分钟（编译 native 模块）
+- 使用 `host` 网络模式，机器人可直接连接局域网 TS3 服务器
+- 数据持久化在 Docker named volume `tsmusicbot-data` 中（数据库、Cookie、日志）
+- 内置健康检查（`/api/health`），支持 Docker 自动重启
+
+```bash
+# 查看日志
+docker logs -f tsmusicbot
+
+# 停止
+docker-compose down
+
+# 重新构建（代码更新后）
+docker-compose up -d --build
+```
+
+如果 TS3 服务器不在同一台机器，可编辑 `docker-compose.yml` 将 `network_mode: host` 替换为端口映射：
+```yaml
+ports:
+  - "3000:3000"
+```
+
 ## 使用说明
 
 ### 首次配置