Files
4an-workorder/4an_deployment_guide.md
T
2025-08-08 10:38:10 +08:00

3.5 KiB
Executable File

4AN项目部署指南

环境变量配置

配置文件app/config.py已更新为支持环境变量。所有配置项可通过环境变量设置,包括:

  • SECRET_KEY: 应用密钥
  • DATABASE_URI: 数据库连接URI
  • LZMX_WEBHOOK_URL: 临猪消息Webhook
  • UPLOAD_FOLDER: 文件上传目录
  • KEY110_DB_HOST: 1key110数据库主机
  • KEY110_DB_USER: 1key110数据库用户
  • KEY110_DB_PASSWORD: 1key110数据库密码
  • KEY110_DB_DATABASE: 1key110数据库名称

使用Supervisor管理项目

安装依赖

项目需要安装python-dotenv包以支持环境变量:

/mnt/nfs/.venv/bin/pip install python-dotenv

环境变量文件

我们已创建环境变量文件 /opt/1panel/docker/compose/4an/4an.env,其中包含所有配置参数:

# 应用密钥
SECRET_KEY=

# 数据库连接
DATABASE_URI=mysql+pymysql://4an:GtbJp6Ai5azntnTB@10.10.10.253/4an

# 临猪消息Webhook
LZMX_WEBHOOK_URL=http://imtwo.zdxlz.com/im-external/v1/webhook/send?key=ef1dc605827f425e96491ce5725b5274

# 文件上传目录
UPLOAD_FOLDER=static/uploads

# 1key110数据库配置
KEY110_DB_HOST=10.10.10.253
KEY110_DB_USER=1key110
KEY110_DB_PASSWORD=KzdKtf7KfkXe7iCN
KEY110_DB_DATABASE=1key110

在启动应用前需要加载这些环境变量:

# 加载环境变量文件
export $(cat /opt/1panel/docker/compose/4an/4an.env | grep -v '^#' | xargs)

配置Supervisor

  1. 确保修改app/config.py使其支持环境变量后,再使用Supervisor管理应用

  2. 4an_supervisor.conf文件复制到Supervisor配置目录:

sudo cp 4an_supervisor.conf /etc/supervisor/conf.d/
  1. 在配置文件目录中创建一个启动脚本,用于加载环境变量并启动应用:
sudo nano /opt/1panel/docker/compose/4an/start_with_env.sh

脚本内容:

#!/bin/bash
# 加载环境变量
export $(cat /opt/1panel/docker/compose/4an/4an.env | grep -v '^#' | xargs)

# 启动uwsgi
exec /mnt/nfs/.venv/bin/uwsgi --ini /opt/1panel/docker/compose/4an/app/uwsgi.ini

设置脚本权限:

sudo chmod +x /opt/1panel/docker/compose/4an/start_with_env.sh
  1. 修改Supervisor配置使用该脚本:
sudo nano /etc/supervisor/conf.d/4an_supervisor.conf

将command行修改为:

command=/opt/1panel/docker/compose/4an/start_with_env.sh
  1. 更新Supervisor配置:
sudo supervisorctl reread
sudo supervisorctl update
  1. 管理4an服务:
# 启动服务
sudo supervisorctl start 4an

# 停止服务
sudo supervisorctl stop 4an

# 重启服务
sudo supervisorctl restart 4an

# 查看服务状态
sudo supervisorctl status 4an

# 查看日志
sudo tail -f /opt/1panel/docker/compose/4an/supervisor.log

使用systemd(可选)

如果需要使用systemd而不是Supervisor,可以创建服务文件:

sudo nano /etc/systemd/system/4an.service

服务文件内容示例:

[Unit]
Description=4AN Application
After=network.target

[Service]
User=root
WorkingDirectory=/opt/1panel/docker/compose/4an/app
ExecStart=/mnt/nfs/.venv/bin/uwsgi --ini /opt/1panel/docker/compose/4an/app/uwsgi.ini
Restart=always
StandardOutput=file:/opt/1panel/docker/compose/4an/systemd.log
StandardError=file:/opt/1panel/docker/compose/4an/systemd_error.log
EnvironmentFile=/opt/1panel/docker/compose/4an/4an.env

[Install]
WantedBy=multi-user.target

然后启用并启动服务:

sudo systemctl daemon-reload
sudo systemctl enable 4an
sudo systemctl start 4an