kt-financial-system/DEPLOYMENT.md

KT财务系统部署文档

🚀 快速部署

方式1：使用部署脚本（推荐）

./deploy.sh

方式2：使用Gitea Actions自动部署

推送代码到main分支后，Gitea Actions会自动触发部署。

📋 部署要求

服务器配置

• IP地址: 172.16.74.149
• 用户: atai
• 端口: 22
• 部署路径: /home/atai/kt-financial-system
• 访问地址: http://172.16.74.149:8080

依赖环境

• Docker
• Docker Compose
• Git

🛠️ 手动部署步骤

1. 安装sshpass（本地Mac）

brew install hudochenkov/sshpass/sshpass

2. 服务器初始化

SSH登录服务器：

ssh atai@172.16.74.149

安装Docker：

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

安装Docker Compose：

sudo curl -L "https://github.com/docker/compose/releases/download/v2.23.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

3. 克隆代码

cd /home/atai
git clone https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system.git
cd kt-financial-system

4. 启动服务

docker-compose up -d --build

5. 查看状态

docker-compose ps
docker-compose logs -f

📝 常用命令

查看日志

docker-compose logs -f

重启服务

docker-compose restart

停止服务

docker-compose down

重新构建

docker-compose up -d --build

清理旧镜像

docker image prune -f

🔧 配置说明

端口映射

• 80 (容器内) → 8080 (宿主机)
• 前端访问: http://172.16.74.149:8080
• API访问: http://172.16.74.149:8080/api

环境变量

在 docker-compose.yml 中配置：

environment:
  - NODE_ENV=production
  - TZ=Asia/Shanghai

🐛 故障排查

容器无法启动

# 查看详细日志
docker-compose logs

# 查看容器状态
docker-compose ps

# 重新构建
docker-compose up -d --build --force-recreate

端口被占用

# 检查端口占用
sudo netstat -tulpn | grep 8080

# 修改docker-compose.yml中的端口映射
ports:
  - "8081:80"  # 改为8081

内存不足

# 清理Docker系统
docker system prune -a

# 限制容器内存
docker-compose.yml中添加:
deploy:
  resources:
    limits:
      memory: 2G

📊 监控

查看资源使用

docker stats kt-financial-system

查看实时日志

docker-compose logs -f --tail=100

🔄 更新部署

自动更新（Gitea Actions）

推送代码到main分支即可自动部署

手动更新

./deploy.sh

或：

ssh atai@172.16.74.149
cd /home/atai/kt-financial-system
git pull origin main
docker-compose up -d --build

📞 技术支持

遇到问题请联系技术团队或查看：

• Gitea: https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system
• Docker文档: https://docs.docker.com