diff --git a/.gitea/workflows/deploy.yaml b/.gitea/workflows/deploy.yaml
index 6f7251b..0b936b4 100644
--- a/.gitea/workflows/deploy.yaml
+++ b/.gitea/workflows/deploy.yaml
@@ -72,13 +72,16 @@ jobs:
           echo "📁 当前目录内容:"
           ls -la
           
-          # 如果配置文件不存在，从当前目录复制
-          if [ ! -f ${{ env.DEPLOY_DIR }}/docker-compose.prod.yml ]; then
-            echo "📋 初始化部署目录..."
-            cp -v docker-compose.prod.yml ${{ env.DEPLOY_DIR }}/
+          # 强制更新 docker-compose.prod.yml（确保使用最新配置）
+          echo "📋 更新部署配置文件..."
+          cp -v docker-compose.prod.yml ${{ env.DEPLOY_DIR }}/
+          
+          # configs 目录只在不存在时初始化（避免覆盖运行时配置）
+          if [ ! -d ${{ env.DEPLOY_DIR }}/configs ] || [ -z "$(ls -A ${{ env.DEPLOY_DIR }}/configs 2>/dev/null)" ]; then
+            echo "📋 初始化配置目录..."
             cp -rv configs/* ${{ env.DEPLOY_DIR }}/configs/
           else
-            echo "✅ 配置文件已存在，跳过复制"
+            echo "✅ 配置目录已存在，保留现有配置"
           fi
           
           cd ${{ env.DEPLOY_DIR }}
diff --git a/debug-deployment.sh b/debug-deployment.sh
new file mode 100644
index 0000000..273db0d
--- /dev/null
+++ b/debug-deployment.sh
@@ -0,0 +1,62 @@
+#!/bin/bash
+set -e
+
+echo "========================================"
+echo "君鸿卡管系统部署诊断脚本"
+echo "========================================"
+echo ""
+
+cd /opt/junhong_cmp
+
+echo "1. 检查镜像信息"
+echo "----------------------------------------"
+docker images | grep junhong/cmp-fiber-api
+echo ""
+
+echo "2. 检查容器状态"
+echo "----------------------------------------"
+docker compose -f docker-compose.prod.yml ps
+echo ""
+
+echo "3. 查看 API 容器详细健康状态"
+echo "----------------------------------------"
+docker inspect junhong-cmp-api --format='{{json .State.Health}}' | jq .
+echo ""
+
+echo "4. 查看 API 容器启动日志（最近 50 行）"
+echo "----------------------------------------"
+docker compose -f docker-compose.prod.yml logs api --tail=50
+echo ""
+
+echo "5. 手动测试健康检查（容器内）"
+echo "----------------------------------------"
+echo "测试 IPv4 (127.0.0.1):"
+docker exec junhong-cmp-api wget --no-verbose --tries=1 --spider http://127.0.0.1:3000/health && echo "✅ 成功" || echo "❌ 失败"
+echo ""
+echo "测试 localhost:"
+docker exec junhong-cmp-api wget --no-verbose --tries=1 --spider http://localhost:3000/health && echo "✅ 成功" || echo "❌ 失败"
+echo ""
+
+echo "6. 从宿主机测试健康检查"
+echo "----------------------------------------"
+curl -s http://localhost:3000/health | jq .
+echo ""
+
+echo "7. 检查端口监听情况（容器内）"
+echo "----------------------------------------"
+docker exec junhong-cmp-api netstat -tlnp 2>/dev/null || docker exec junhong-cmp-api ss -tlnp
+echo ""
+
+echo "8. 查看环境变量"
+echo "----------------------------------------"
+docker exec junhong-cmp-api env | grep -E "DB_|CONFIG_ENV"
+echo ""
+
+echo "9. 检查配置文件"
+echo "----------------------------------------"
+docker exec junhong-cmp-api cat /app/configs/config.yaml | grep -A 3 "server:"
+echo ""
+
+echo "========================================"
+echo "诊断完成"
+echo "========================================"