Pulse

主题

配置 ​

面板的全部配置都通过环境变量给。没有配置文件 —— 一份 systemd unit 或者一段 compose 就能把部署说清楚。

环境变量 ​

变量默认说明
PULSE_BIND127.0.0.1:25774监听地址
PULSE_PUBLIC_URL由监听地址推导生成安装命令时写进去的地址，装在别的机器上必须设对
PULSE_DATABASE_URLsqlite://data/pulse.db数据库位置，也支持 postgres://
PULSE_DATA_DIRdata数据目录（GeoIP 缓存、服务端密钥）
PULSE_WEB_DIRweb/dist前端静态文件目录
PULSE_ADMIN_PASSWORD随机首次启动创建管理员用，≥8 位
PULSE_TLS_CERT / PULSE_TLS_KEY空配上就直接跑 HTTPS，两个必须同时给
PULSE_TRUSTED_PROXY_HOPS0放在反代后面时设成代理层数
PULSE_PUBLIC_MODEpublic设成 private 则公开页需要登录
PULSE_TIMEZONEAsia/Shanghai面板时区，影响账单周期的日界
PULSE_DISPLAY_CURRENCYCNY汇总金额用的币种
PULSE_RATE_BASE_URL内置汇率源（Frankfurter 兼容接口）
PULSE_VISITOR_BADGEtrue页脚显示访客 IP / 系统 / 浏览器
PULSE_LOGinfo日志级别

关于时区 ​

账单周期是「你和商家的约定」，用统一时区才可解释。机器时区五花八门的话， 同一天的流量重置会发生在不同时刻。所以周期日界一律按 PULSE_TIMEZONE 算， 不看机器自己的时区。

PostgreSQL ​

50～200 台机器用 SQLite 足够。规模再大时可以切 PostgreSQL：

bash
PULSE_DATABASE_URL=postgres://user:pass@localhost/pulse ./pulse-server

两套迁移是分开维护的 —— 两边的类型系统和索引语法差别大到不值得用一套 SQL 硬凑。

反向代理 ​

nginx 的最小配置：

nginx
location / {
    proxy_pass http://127.0.0.1:25774;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_read_timeout 3600s;   # WebSocket 是长连接，短了会每分钟踢一次
}

配了反代一定要设 PULSE_TRUSTED_PROXY_HOPS，否则登录限流和访客标签 看到的都是反代自己的 IP。默认 0 是「直连部署」的正确取值。

自签证书 / 私有 CA ​

内网部署或域名还没备案时可以用。探针默认只信任内置的公共 CA 列表， 所以要额外告诉它信任你的 CA：

bash
curl -fsSL https://panel.example.com/install.sh | sudo bash -s -- \
  --server wss://panel.example.com --token <TOKEN> \
  --ca-cert /etc/pulse-agent/ca.pem

这是「往信任集里加一条」，不是「关掉校验」 —— 证书链、有效期、主机名照样验。 没有跳过校验的开关，也不打算加。

openssl req -x509 直接签出来的是 CA 证书，探针会拒绝（CaUsedAsEndEntity）。 服务器证书要用 basicConstraints=CA:FALSE + extendedKeyUsage=serverAuth 单独签， 且 SAN 里要包含你连的那个域名或 IP。

基于 MIT 许可发布

Pulse