部署到 FreeBSD
本示例演示如何将 Lolly 交叉编译并部署到 FreeBSD 服务器。
前置条件
- 本地开发机已安装 Go 1.26+
- 目标 FreeBSD 服务器可通过 SSH 访问
- 本地已配置 SSH 密钥登录（免密码）
部署步骤
1. 交叉编译
make build-freebsd
# 输出: bin/lolly-freebsd-amd64
2. 上传到服务器
scp -P 29888 bin/lolly-freebsd-amd64 root@192.168.1.15:/tmp/
3. 安装
SSH 登录到 FreeBSD 服务器执行：
# 创建目录
mkdir -p /usr/local/etc/lolly
mkdir -p /var/log/lolly
mkdir -p /var/db/lolly
mkdir -p /var/www/lolly
# 安装二进制
mv /tmp/lolly-freebsd-amd64 /usr/local/sbin/lolly
chmod 755 /usr/local/sbin/lolly
# 复制配置文件
cp /path/to/your/lolly.yaml /usr/local/etc/lolly/lolly.yaml
# 安装启动脚本
cp examples/deploy-freebsd/lolly.rc.d /usr/local/etc/rc.d/lolly
chmod 755 /usr/local/etc/rc.d/lolly
# 启用开机启动
sysrc lolly_enable="YES"
# 启动服务
service lolly start
服务管理
| 命令 | 说明 |
|---|---|
service lolly start |
启动 |
service lolly stop |
停止 |
service lolly restart |
重启 |
service lolly status |
查看状态 |
service lolly reload |
热重载配置 (HUP) |
service lolly rotate |
重新打开日志 (USR1) |
目录结构
| 路径 | 用途 |
|---|---|
/usr/local/sbin/lolly |
二进制程序 |
/usr/local/etc/lolly/lolly.yaml |
配置文件 |
/usr/local/etc/rc.d/lolly |
启动脚本 |
/var/log/lolly/ |
日志目录 |
/var/db/lolly/ |
数据目录 |
/var/www/lolly/ |
Web 根目录 |
/var/run/lolly.pid |
PID 文件 |
配置文件示例
最小可用配置：
servers:
- listen: ":8080"
name: "localhost"
static:
- path: "/"
root: "/var/www/lolly"
index:
- "index.html"
logging:
format: "text"
access:
path: "/var/log/lolly/access.log"
error:
path: "/var/log/lolly/error.log"
level: "info"
故障排查
检查服务状态
service lolly status
ps aux | grep lolly
sockstat -4 -l | grep 8080
查看日志
tail -f /var/log/lolly/error.log
tail -f /var/log/lolly/access.log
测试配置
/usr/local/sbin/lolly -c /usr/local/etc/lolly/lolly.yaml
# 前台运行，Ctrl+C 停止
权限问题
如果启动失败提示 Permission denied：
# 确保配置文件可读
chmod 644 /usr/local/etc/lolly/lolly.yaml
chown root:wheel /usr/local/etc/lolly/lolly.yaml
# 确保日志目录存在且可写
chown -R root:wheel /var/log/lolly