用宝塔面板搭建服务端
🌐 壹信 IM 后端 - 宝塔部署详细指南
📂 文件结构详解
baota/
├── server # 服务主程序（Linux amd64, 15MB）
├── config.yaml # 核心配置文件（需根据环境修改）
├── init.sql # MySQL 数据库初始化脚本（表结构）
├── start.sh # 启动脚本（开发测试用）
├── stop.sh # 停止脚本（开发测试用）
├── restart.sh # 重启脚本（开发测试用）
├── yixinim.service # systemd 服务文件（生产环境用）
├── uploads/ # 上传文件目录（存储用户头像、消息附件等）
└── README.md # 本文档🔐 默认管理员信息
admin123456🛠️ 详细部署步骤
1. 上传文件（详细步骤）
1.
2.
3.
4.
2. 设置权限（详细步骤）
3. 配置数据库（详细步骤）
🐬 MySQL 配置
1.
2.
3.
🧪 MongoDB 配置
1.
2.
3.
4.
⚡ Redis 配置
1.
2.
4. 修改 JWT 密钥（详细步骤）
1.
2.
5. 配置服务器地址（详细步骤）
1.
http://127.0.0.1:8080https://api.yourdomain.com2.
base_url 必须与反向代理的域名一致https://api.yourdomain.com 访问，则 base_url 必须为 https://api.yourdomain.com6. 启动服务（详细步骤）
方式一：使用脚本（开发测试）
方 式二：使用 systemd（生产环境推荐）
7. 配置反向代理（详细步骤，含WebSocket支持）
方法一：宝塔反向代理（简单）
1.
2.
http://127.0.0.1:8080$host3.
https://api.yourdomain.com 应该能访问服务方法二：伪静态配置（推荐，支持WebSocket）
1.
2.
3.
4.
8. 配置 SSL（详细步骤）
1.
2.
3.
4.
5.
https://api.yourdomain.com 应该能通过HTTPS访问🛠️ 常用命令（详细说明）
| 命令 | 说明 |
|---|---|
tail -f /www/wwwroot/yixinim/server.log | 实时查看服务日志 |
ps aux | grep yixinim | 查看服务进程 |
netstat -tlnp | grep 8080 | 查看8080端口占用情况 |
systemctl status yixinim | 查看systemd服务状态 |
journalctl -u yixinim -f | 查看systemd服务实时日志 |
chmod +x /www/wwwroot/yixinim/start.sh | 重新设置启动脚本权限 |
chown www:www /www/wwwroot/yixinim/uploads | 设置上传目录所有者 |
🔐 防火墙配置（详细步骤）
1.
2.
3.
❓ 详细常见问题及解决方案
1. 启动失败（常见原因及解决）
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 服务无法启动 | 数据库连接失败 | 检查config.yaml中的MySQL/MongoDB配置，确保密码正确 |
| 服务无法启动 | 端口被占用 | netstat -tlnp | grep 8080，停止占用端口的进程 |
| 服务无法启动 | 权限不足 | chmod 755 /www/wwwroot/yixinim/server |
| 服务启动后立即退出 | 配置文件错误 | 检查config.yaml格式，使用yamllint验证 |
| 服务启动后无法访问 | 未配置反向代理 | 按照指南配置Nginx反向代理 |
2. WebSocket 连接失败（详细解决方案）
1.
2.
3.
4.
3. 上传文件失败（详细解决方案）
1.
2.
3.
4.
4. 500 错误（消息发送失败）
1.
yixinim_messages库的readWrite权限2.
config.yaml中的mongodb.uri是否正确authSource参数正确3.
systemctl restart yixinim✅ 部署完成验证
1.
https://api.yourdomain.com/api/v1/health{"status": "ok"}2.
https://api.yourdomain.com/adminadmin/123456 登录3.
💡 附加建议
1.
2.
systemctl status yixinim定期检查3.
📌 总结
1.
2.
3.
4.
重要提示: 首次部署完成后，务必立即修改管理员密码，这是保障系统安全的第一步！
修改于 2026-03-06 16:20:55