安装
Panlox 是单个静态编译的二进制,不依赖任何运行时。支持 Linux(amd64 / arm64) 与 Windows(amd64)。以下以 Linux 为例。
curl -fsSL https://get.panlox.com | sh sudo panlox serve --port 8080第一条命令下载与当前架构匹配的最新稳定版,装到 /usr/local/bin/panlox。 第二条在前台启动,浏览器访问 http://服务器IP:8080 即可。
注册为系统服务
生产环境建议交给 systemd 托管,开机自启、异常自动重启。
sudo panlox service install sudo systemctl enable --now panlox首次登录
首次启动会在终端打印一个一次性初始化令牌。用它在浏览器里创建第一个管理员账号, 创建完成后令牌立即失效。
sudo panlox token show # 输出:http://127.0.0.1:8080/setup?token=8f3a2c…升级
替换二进制后重启服务即可,配置与数据原地保留。升级前建议先备份数据目录。
sudo panlox upgrade sudo systemctl restart panloxpanlox upgrade 会先下载新版本到临时目录,校验签名,再原子替换。 替换失败时旧二进制保持不变,服务不会中断。
站点与反向代理
站点分两类:静态站点与反向代理。两者都可以绑定域名并自动申请证书。 证书走 HTTP-01 校验,需要域名的 80 端口可达。
panlox site add \ --domain example.com \ --upstream 127.0.0.1:3000 \ --tls auto数据库
面板可以管理本机的 MySQL、PostgreSQL 与 Redis。建库时会同时创建同名用户, 密码自动生成并可一键复制。远程访问默认关闭,需要显式放行来源 IP。
备份策略
备份任务支持本地目录、SFTP 与 S3 兼容对象存储三种目标。每个任务可以设保留份数, 超出后按时间删除最旧的一份。备份完成后会自动做一次完整性校验。
panlox backup add \ --source /var/lib/panlox \ --target s3://my-bucket/panlox \ --keep 14 \ --cron "0 3 * * *"命令行
面板的所有操作都有对应的命令行入口,便于写进自动化脚本。
panlox status # 服务与依赖的运行状态 panlox site list # 列出全部站点 panlox db list # 列出数据库 panlox backup run --now # 立即执行一次备份 panlox logs --follow # 跟踪面板日志配置文件
配置文件位于 /etc/panlox/config.toml,修改后需重启生效。 绝大多数配置也能在界面里改,界面改会同步写回该文件。
[server] addr = "0.0.0.0:8080" data_dir = "/var/lib/panlox" [metrics] interval = "5s" retention = "720h"常见错误
端口被占用:lsof -i:8080 找到占用进程,或改 --port 换一个端口。
证书申请失败:确认域名已解析到本机、80 端口对外可达、 且没有被前置 CDN 拦住。HTTP-01 校验不支持只开 443 的场景。
升级后无法登录:多半是数据目录权限被改。确认 /var/lib/panlox 属主是运行服务的用户。