ario_server/install-zh.md at 4a7f5d52b33e1cd2d08ee137d1ba471dca8d4399

shanshanzhong c582087c0f

Build docker and publish / build (20.15.1) (push) Failing after 6m27s

Details

refactor: 更新项目引用路径从perfect-panel/ppanel-server到perfect-panel/server

feat: 添加版本和构建时间变量
fix: 修正短信队列类型注释错误
style: 清理未使用的代码和测试文件
docs: 更新安装文档中的下载链接
chore: 迁移数据库脚本添加日志和订阅配置

2025-10-13 01:33:03 -07:00

3.4 KiB

Raw Blame History

安装说明

前置系统要求

Mysql 5.7+ (推荐使用8.0)
Redis 6.0+ (推荐使用7.0)

二进制安装

1.确定系统架构，并下载对应的二进制文件

下载地址：https://github.com/perfect-panel/server/releases

示例说明：系统：Linux amd64，用户：root，当前目录：/root

下载二进制文件

$ wget https://github.com/perfect-panel/server/releases/download/v1.0.0/ppanel-server-linux-amd64.tar.gz

解压二进制文件

$ tar -zxvf ppanel-server-linux-amd64.tar.gz

$ cd ppanel-server-linux-amd64

赋予二进制文件执行权限

$ chmod +x ppanel-server

创建 systemd 服务文件

$ cat > /etc/systemd/system/ppanel.service <<EOF
[Unit]
Description=PPANEL Server
After=network.target

[Service]
ExecStart=/root/ppanel-server-linux-amd64/ppanel-server
Restart=always
User=root
WorkingDirectory=/root/ppanel-server-linux-amd64

[Install]
WantedBy=multi-user.target
EOF

重新加载 systemd 服务

$ systemctl daemon-reload

启动服务

$ systemctl start ppanel

其他说明

安装路径：二进制文件将解压到 /root/ppanel-server-linux-amd64 目录下
systemd 服务：
- 服务名称：ppanel
- 服务配置文件：/etc/systemd/system/ppanel.service
- 服务启动命令：systemctl start ppanel
- 服务停止命令：systemctl stop ppanel
- 服务重启命令：systemctl restart ppanel
- 服务状态命令：systemctl status ppanel
- 服务开机自启：systemctl enable ppanel
设置开机自启可通过以下命令开机自启
```
$ systemctl enable ppanel
```
服务日志：服务日志默认输出到 /root/ppanel-server-linux-amd64/ppanel.log 文件中
可通过 journalctl -u ppanel -f 查看服务日志
当配置文件为空或者不存在的情况下，服务会使用默认配置启动，配置文件路径为：./etc/ppanel.yaml，请通过http://服务器地址:8080/init 初始化系统配置

NGINX 反向代理配置

以下是反向代理配置示例，将 ppanel 服务代理到 api.ppanel.dev 域名下

server {
    listen 80;
    server_name ppanel.dev;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header REMOTE-HOST $remote_addr;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_http_version 1.1;
        
        add_header X-Cache $upstream_cache_status;
        
       #Set Nginx Cache
       
        set $static_filezbsQiET1 0;
        if ( $uri ~* "\.(gif|png|jpg|css|js|woff|woff2)$" )
        {
            set $static_filezbsQiET1 1;
            expires 1m;
            }
        if ( $static_filezbsQiET1 = 0 )
        {
            add_header Cache-Control no-cache;
        }
    }
}

如果使用cloudflare代理服务，需要获取到用户真实访问IP。请在Nginx配置文件中Http段落中加入:

需要依赖：ngx_http_realip_module模块，使用nginx -V命令查看nginx是否已经编译该模块，没有的话需要自己编译。

    # cloudflare Start
    set_real_ip_from 0.0.0.0/0;
    real_ip_header  X-Forwarded-For;
    real_ip_recursive on;
    # cloudflare END

3.4 KiB Raw Blame History Unescape Escape