本文将详细介绍如何在基于 Debian 12 的服务器环境中部署 MacCMS Tools —— 一款面向 Apple CMS（苹果CMS）生态的现代化维护与管理平台。本教程以宝塔面板（BT Panel）为操作界面，兼顾命令行用户需求。
系统环境要求
✅ 支持的操作系统
| 操作系统 | 最低版本要求 | 说明 |
|---|---|---|
| Ubuntu | 22.04+ | 原生支持 |
| Debian | 12 (Bookworm)+ | 原生支持 |
| Rocky Linux | 9+ | 原生支持 |
| CentOS Stream | 9+ | 原生支持 |
| AlmaLinux | 9+ | 原生支持 |
⚠️ 注意：CentOS 7、Ubuntu 20.04、Debian 11 等旧版系统因依赖库兼容性问题，可能导致安装失败，不建议使用。
Python 环境配置
MacCMS Tools 依赖 Python 3.12.12。若使用宝塔面板，请按以下步骤操作：
- 进入 网站 → Python 项目 → Python 环境管理 → 版本管理；
- 查找 Python 3.12.12，如未显示，请点击“所有版本”进行安装；
- 安装完成后，在终端执行以下命令验证版本：
python3 --version正确输出应为：Python 3.12.12
💡 提示：务必确保 Python 版本精确匹配，否则程序将无法正常运行。
一键安装 MacCMS Tools
执行以下命令完成程序自动部署：
curl -sSL https://miui.ink/cdn/maccmstools/sh/install_maccms_tools.sh | sudo bash当终端提示 “安装完成” 后，程序已成功部署至默认路径 /www/wwwroot/MacCmsTools。
在宝塔面板中配置 Python 项目
1. 添加虚拟环境
- 进入 网站 → Python 项目 → 虚拟环境管理；
- 点击“添加”，路径填写：
/www/wwwroot/MacCmsTools/.venv - 📌 注意：必须选择项目目录下的
venv虚拟环境，而非系统级 Python 3.12.12。此设计确保依赖隔离，便于后续卸载（仅需删除项目目录即可，无残留）。
2. 创建新项目
- 项目名称：
MacCmsTools - Python 环境：选择刚添加的
.(venv) - 启动方式：命令行启动
- 项目路径：
/www/wwwroot/MacCmsTools - 启动命令：
gunicorn --worker-class eventlet -w 1 -b 0.0.0.0:5000 app:app - 环境变量：留空
- 启动用户：
www - 安装依赖：留空（若宝塔自动填充，请手动清除）
⚠️ 切勿勾选“自动安装依赖”，否则可能覆盖虚拟环境中的正确依赖。
点击“确定”后，宝塔将自动初始化并启动服务。首次启动可能需要数十秒。
域名绑定与反向代理配置
1. 绑定域名
在宝塔面板中为该项目绑定您的自定义域名（如 tools.yourdomain.com）。
2. 开放端口
确保服务器防火墙及安全组已放行 5000 端口（程序监听端口）。
3. 配置 Nginx 反向代理
编辑站点的 Nginx 配置文件，在 server 块底部找到 # proxy 注释区域，替换为以下内容：
location / {
proxy_pass http://127.0.0.1:5000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header REMOTE-HOST $remote_addr;
add_header X-Cache $upstream_cache_status;
proxy_set_header X-Host $host:$server_port;
proxy_set_header X-Scheme $scheme;
proxy_connect_timeout 30s;
proxy_read_timeout 86400s;
proxy_send_timeout 30s;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}保存并重载 Nginx 配置。
访问应用
完成上述步骤后，通过浏览器访问您绑定的域名（如 https://tools.yourdomain.com），即可进入 MacCMS Tools 管理界面。
