From 45da2d1d0c1ef59b7322655f579f5be7b1de1b43 Mon Sep 17 00:00:00 2001
From: Agent <agent@localhost>
Date: Sun, 24 May 2026 15:40:15 +0800
Subject: [PATCH] docs: rewrite Docker Compose deployment guide with copy-paste
 commands

---
 README.md | 80 +++++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 57 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index 554b993..f35103f 100644
--- a/README.md
+++ b/README.md
@@ -33,48 +33,70 @@ LISTEN_ADDR=:9090 ./mirror-proxy
 
 ## Docker 部署
 
-### 使用 Docker 直接运行
+### 使用 Docker Compose（推荐）
+
+无需克隆仓库，一条命令即可完成部署。
+
+**1. 创建 `docker-compose.yml`**
 
 ```bash
-# 构建镜像
-docker build -t mirror-proxy .
-
-# 运行容器（首次运行会自动创建 config.json）
-docker run -d \
-  --name mirror-proxy \
-  -p 8080:8080 \
-  -v $(pwd)/config.json:/app/config.json \
-  -v $(pwd)/cache:/app/cache \
-  --restart unless-stopped \
-  mirror-proxy
+cat > docker-compose.yml << 'EOF'
+services:
+  mirror-proxy:
+    image: ghcr.io/arkylin/mirror-proxy:latest
+    container_name: mirror-proxy
+    restart: unless-stopped
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./config.json:/app/config.json
+      - ./cache:/app/cache
+    environment:
+      - TZ=Asia/Shanghai
+EOF
 ```
 
-### 使用 Docker Compose
+**2. 启动服务**
 
 ```bash
-# 启动服务
 docker-compose up -d
+```
 
+首次启动会自动创建 `config.json`（默认账号 `admin` / `admin123`）。
+
+**3. 常用命令**
+
+```bash
 # 查看日志
 docker-compose logs -f
 
+# 查看运行状态
+docker-compose ps
+
 # 停止服务
 docker-compose down
+
+# 重启服务
+docker-compose restart
+
+# 更新到最新镜像
+docker-compose pull && docker-compose up -d
 ```
 
-`docker-compose.yml` 已包含端口映射和卷挂载：
-- `./config.json:/app/config.json` — 配置文件持久化
-- `./cache:/app/cache` — 缓存目录持久化
+**4. 管理后台**
 
-### 使用 GHCR 镜像（免构建）
+访问 `http://<服务器IP>:8080/admin/`，默认账号：
+- 用户名：`admin`
+- 密码：`admin123`
 
-每次 push 到 `main` 分支或打 `v*` 标签时，会自动构建并推送镜像到 GHCR。
+> 建议首次登录后立即在 **系统设置** 中修改密码。
+
+---
+
+### 使用 Docker 直接运行
 
 ```bash
-# 拉取最新镜像
-docker pull ghcr.io/arkylin/mirror-proxy:latest
-
-# 运行
+# 拉取并运行（首次运行自动生成 config.json）
 docker run -d \
   --name mirror-proxy \
   -p 8080:8080 \
@@ -84,6 +106,18 @@ docker run -d \
   ghcr.io/arkylin/mirror-proxy:latest
 ```
 
+---
+
+### 自行构建镜像
+
+如需本地构建：
+
+```bash
+# 克隆仓库后执行
+docker build -t mirror-proxy .
+docker run -d --name mirror-proxy -p 8080:8080 mirror-proxy
+```
+
 ## 使用方式
 
 ### 1. Docker Hub / GHCR（daemon.json 方式）