部署相关问题
本文汇总了部署智站CMS时常见的问题和解决方案。
安装相关
安装向导打不开 — 检查服务是否启动,检查端口是否被占用,查看程序日志找错误信息,确认防火墙是否开放了端口。
数据库连接失败
SQLite — 检查数据库文件路径是否正确,检查目录是否有写入权限,确认SQLite驱动正常。
MySQL — 检查MySQL服务是否启动,确认数据库地址/端口/用户名/密码正确,确认数据库已创建,检查用户是否有访问权限,网络不通的话检查防火墙和安全组。
页面显示502 Bad Gateway — 这通常是Nginx反向代理配置问题:确认后端服务是否在运行,检查反向代理的地址和端口是否正确,查看Nginx错误日志。
宝塔面板相关
宝塔如何配置反向代理
- 进入宝塔面板 → 网站 → 站点设置
- 点击「反向代理」→「添加反向代理」
- 目标URL填写:http://127.0.0.1:8080
- 发送域名选择「不发送」
- 代理名称随便填
- 提交保存
静态资源加载不正常 — 可能是反向代理没有正确处理静态资源:确保反向代理配置正确,程序目录有读取权限,静态文件存在。
服务管理
如何设置开机自启 — 使用systemd管理服务,参考安装部署文档中的systemd配置方法。
如何查看程序日志 — 使用journalctl命令查看systemd服务的日志,或直接运行程序查看输出。
如何重启服务 — 使用systemctl restart命令,或直接kill掉进程重新启动。
性能问题
访问速度慢怎么办
- 开启静态化:生成静态页面,速度最快
- 使用CDN:静态资源使用CDN加速
- 数据库优化:数据量大的话考虑用MySQL代替SQLite
- 服务器配置:升级服务器配置
- 图片优化:压缩图片大小,使用图床
内存占用高怎么办 — 减少并发数,及时清理不需要的数据,考虑使用Agent分布式部署分担压力,SQLite单连接并发高时建议换MySQL。
域名和SSL
如何绑定域名
- 将域名解析到服务器IP
- 在宝塔面板中添加站点
- 配置反向代理到后端服务
- 申请SSL证书(建议开启)
如何配置HTTPS
- 在宝塔面板中申请Let's Encrypt免费证书
- 或者上传自己的SSL证书
- 开启强制HTTPS
升级相关
如何升级程序
- 备份数据库和配置文件
- 停止旧服务
- 替换新的二进制文件
- 启动新服务
- 检查功能是否正常
数据库迁移会自动执行,不需要手动操作。
升级后数据会丢失吗 — 不会。升级只会替换程序文件,数据都在数据库中,不会受到影响。但升级前还是建议备份。
Agent相关问题
Agent连不上怎么办 — 检查Agent是否在运行,检查配置文件中的服务端地址是否正确,检查Token是否正确,检查网络是否能访问主控端,查看Agent日志找错误信息。
Agent部署站点失败 — 检查Nginx是否安装并运行,检查Agent是否有Nginx配置目录的写入权限,检查磁盘空间是否充足,查看Agent日志和任务日志。