【教程】宝塔面板上安装sspanel-uim-手把手指南

科技与创作
1

SSPanel是经典的node 管理/分发面板，而且更新和活跃度非常好。他的官方文档只写了全程在空白新服务器上的安装步骤。往往这些主控客户入口，我们会选择放在性能和并发比较好的主服务器端，而主服务器群往往又是用宝塔或类似主机面板来维护的，兼容邮局、网站等一系列服务，甚至还要去监控其他服务器群。那么如何在宝塔面板下安装SSPanel而解决兼容问题呢？今天就来分享一下宝塔面板下如何安装sspanel。

此外，本站的SSPanel招募运营节点的伙伴，如果你想推广你的节点，让本站用户可以用积分免费试用你的节点，或者你热爱分享，记得联系我。我们会根据你的要求添加你的节点，给本站的用户花积分试用，为您宣传。

由于新用户只能发一张图，需要截图教程的请移步： https://fault.at/宝塔面板上安装sspanel-uim-手把手指南/

1、SSPanel介绍

概述

SSPanel-UIM 是一个基于 PHP 的代理服务管理面板，具有以下特点：

  • 多协议支持：支持 Shadowsocks、V2Ray、Trojan、Hysteria 等主流协议

  • 用户管理：完善的用户注册、订阅、流量统计系统

  • 节点管理：支持多节点管理、负载均衡、智能路由

  • 财务系统：支持多种支付方式、套餐管理、佣金系统

  • 运营工具：工单系统、邮件通知、数据统计等

系统要求

在开始安装前，请确保您的服务器满足以下要求：

最低配置

  • CPU: 1核心

  • 内存: 1GB RAM

  • 存储: 10GB 可用空间

  • 网络: 稳定的网络连接

推荐配置

  • CPU: 2核心或以上

  • 内存: 2GB RAM 或以上

  • 存储: 20GB SSD

  • 网络: 高质量网络连接

软件环境

  • 操作系统: Ubuntu 20.04+ / CentOS 8+ / Debian 11+

  • Web服务器: Nginx

  • PHP: 8.2 或以上版本

  • 数据库: MySQL 8.0+ 或 MariaDB 10.6+

  • 缓存: Redis 7.0+

2、开始安装-宝塔准备

本次实战的服务器为Netcup RS G11 4C8G；ubuntu 24；宝塔面板9.6免费版；

宝塔面板准备：【您可以打开sspanel手动安装指南和本教程一起参考阅读：{链接数受限，请移步原文}】

  1. 在宝塔面板应用商城中，安装一个PHP 8.2 。【目前宝塔的PHP8.4未支持yaml拓展，未省去不必要的麻烦，我们安装PHP8.2】添加到首页方便找到它

  2. 安装PHP拓展：在应用商城或首页点击PHP8.2，在弹出的面板左侧点击安装拓展，选择拓展安装。需要安装的拓展有：fileinfo,opcache,redis,gmp,yaml 【如果你在这台服务器已经装了低于8.2版本的php并安装过redis，本次会卸载低版本的redis重新安装一个，之前使用redis的程序需要重新设置连接这个新的redis，为了防止串号，不同程序使用同个redis最好指定不同的redis数据库号（默认database0），具体可以留言交流】

  3. PHP禁用函数（重要）：安装好扩展后，点击左边【禁用函数】，先启用putenv（从禁用列表中删除）。注意，如果下一步开始安装sspanel过程中出现错误，再返回此处尝试开启proc_open，exec，非必要不开启。

  4. 通过宝塔面板【Docker】菜单安装MariaDB；首次进入Docker会提示安装composer，按提示操作即可。Docker准备好后进入docker-应用商店-搜索mariadb，一键安装即可。【为了更好数据库性能，本次选用mariadb，正好可以测试一下网站环境如何接入docker数据库】

  5. 安装完docker mariadb后，在宝塔面板-数据库-新建数据库-输入你选择的数据库名称、用户名、密码；访问权限选择所有人，添加至：选择你刚创建的mariadb容器。

  6. 安装apt和git【不同于官方文档，你在宝塔服务器只需要安装apt和git】打开宝塔面板左侧【终端】，逐条运行下面的命令即可：

    apt update && apt upgrade -y

    apt install git

  7. 创建网站，在宝塔版面【网站】添加网站，【传统项目】,输入你要绑定的域名。在默认根目录后面加上/sspanel/public【如果忘了这一步，可以后续再回来添加】

  8. Nginx设置：创建完网站后，点击你创建的网站，在打开面板点击左侧【配置文件】，在右侧加入sspanel的nginx规则代码：

    #sspanel settings面板设置
    location / {
        try_files $uri /index.php$is_args$args;
    }
    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi-82.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

  9. 部署SSL证书：在宝塔面板-左侧【网站】-看到网站列表 – 找到你创建的sspanel网站，看后面【SSL证书】列，点击根据引导部署证书。一般选择Let’s Encrypt，勾选你绑定的域名，选择【文件验证】。根据引导自动申请，最后保存，部署完成。

  10. 至此，一系列准备完成，可以安装了。

3、开始安装SSPanel

  1. 【GIT克隆文件】进入宝塔面板-左侧【文件】-进入目录【/www/wwwroot/你的域名/】删除除了.wellknown文件夹以外的文件，删不掉可以多试几次。如果你不清楚为什么，可以不删除。

  2. 点击文件管理界面，当前目录（你的网站文件目录），上方的【终端】，待命令窗口弹出显示root@..后输入命令：

    git clone https://github.com/Anankke/SSPanel-UIM.git sspanel

  3. 顺利运行之后【确认运行结束】，关闭终端，刷新当前目录，查看程序文件/sspanel是否都已经同步完成。

  4. 确认文件同步成功后再次打开终端，设置git安全目录，运行命令(注意替换网站实际目录)：

    git config --global --add safe.directory /www/wwwroot/你的域名/sspanel

  5. 此时，sspanel应该装在/www/wwwroot/你的域名/sspanel目录，进入sspanel文件夹，查看内容是否和git官方的一致。如果一致，会有public文件夹，这将是你网站对外访问目录。如果你之前没有设置网站的根目录，此时再次确认你已经设置过。【宝塔面板-左侧菜单-网站-选择你的网站-网站目录-运行目录（输入/sspanel/public）-保存】

  6. 开始安装composer依赖：

  7. 在你的网站设置面板【宝塔面板-左侧菜单-网站-选择你的网站-其他设置-点击composer选项卡】。你可以在composer版本处选择升级composer，升级完成后继续在本页操作：选择好composer版本，PHP版本，执行参数选择install，补充命令输入：

    --no-dev --optimize-autoloader

    镜像源，国内服务器选择阿里云（你要是在国内服务器就还是别装sspanel了，你懂的）；国外服务器选择官方源。执行用户www即可，执行目录要点击选择sspanel目录。否则无法执行。如果composer执行报错，回到前面PHP设置禁用函数处，尝试开启【proc_open，exec】后重试。

  8. 执行完毕后你的composer依赖就安装完成了。进行下一步之前，确认终端窗口执行完毕，关闭终端。

  9. 【最后的config】来到【文件】-【你的网站目录/sspanel/config】-将.config.example.php文件和appprofile.example.php文件各原地复制一份，重命名为.config.php和appprofile.php文件。

  10. 双击打开.config.php文件，修改域名和数据库信息：

    //基本设置--------------------------------------------------------------------------------------------------------------
$_ENV['appName'] = '网页显示网站名称';         // 站点名称
$_ENV['baseUrl'] = 'https://你的域名'; // 站点地址，必须以https://开头，不要以/结尾
//数据库设置--------------------------------------------------------------------------------------------------------------
// db_host|db_socket 二选一，若设置 db_socket 则 db_host 会被忽略，不用请留空
// db_host 例: localhost（可解析的主机名）, 127.0.0.1（IP 地址）
// db_socket 例：/var/run/mysqld/mysqld.sock（需使用绝对地址）
$_ENV['db_host'] = '172.18.0.2'; //如果你用了docker mariadb程序，这个ip要去docker中查看
$_ENV['db_socket'] = '';
$_ENV['db_database'] = 'sspanel'; // 数据库名
$_ENV['db_username'] = 'sspanel';    // 数据库用户名
$_ENV['db_password'] = '*****'; // 数据库密码
$_ENV['db_port'] = '3306';        // 端口

  11. 【重点注意】在配置config文件时，高级部分有db_prefix前缀，此处什么都不要填。很多人习惯给数据表加前缀，但目前sspanel初始化不会添加这个前缀，导致数据库安装问题，所以不要填，留空：

    #高级
$_ENV['db_charset'] = 'utf8mb4';
$_ENV['db_collation'] = 'utf8mb4_unicode_ci';
$_ENV['db_prefix'] = ''; //注意留空，这些字段基本都不要修改

  12. 其中数据库的ip地址，如果你跟本教程一样使用了docker安装的mariadb，那么你的ip不能填localhost。去宝塔面板-Docker-容器-找到你的mariadb容器，点击【管理】，在弹出的窗口找到ip和端口：

完成安装

至此已经全部配置完成，准备初始化数据库，在开始之前请确认：

  1. 已执行 composer安装依赖

  2. 已配置好 .config.php 中的数据库连接信息

  3. 确保 /sspanel/vendor/autoload.php 文件存在

  1. 在宝塔面板-文件-网站目录/sspanel目录，点开【终端】，依次执行以下命令：

    # 执行数据库迁移（初始化全新数据库）
php xcat Migration new
# 更新到最新数据库版本
php xcat Migration latest
# 导入配置项
php xcat Tool importSetting
# 创建管理员账户
php xcat Tool createAdmin

  2. 创建管理员账户时按提示输入账户邮箱和密码即可；完成后关闭终端。

最后，设定定时任务

  1. 宝塔面板-左侧菜单-计划任务-添加任务-执行周期（N分钟）- 填入5（分钟）

    脚本内容如下：（将“你的域名”替换成你的网址）

    /www/server/php/82/bin/php /www/wwwroot/你的域名/sspanel/xcat Cron >> /www/wwwroot/你的域名/log/sspanel-cron.log 2>&1

  2. 最后，根据这个任务，在/www/wwwroot/你的域名/网站目录下新建log文件夹，新建sspanel-cron.log空白文件，用于保存计划任务记录。

  3. 此时你可以回到计划任务，手动执行这条新任务，再回到sspanel-cron.log文件双击打开后，看有没有生成记录：（类似记录如下）

    2025-07-27 19:40:02 等待中订单处理完成
2025-07-27 19:40:02 TABP订单激活处理完成
2025-07-27 19:40:02 流量包订单激活处理完成
2025-07-27 19:40:02 时间包订单激活处理完成
2025-07-27 19:40:02 充值订单激活处理完成
2025-07-27 19:40:02 付费用户过期检测完成
2025-07-27 19:40:02 付费用户用量限制提醒完成
2025-07-27 19:40:02 更新节点 IP 完成
2025-07-27 19:40:02 节点离线检测完成
2025-07-27 19:40:02 邮件队列为空

完成，登录网站

  1. 现在，你可以访问你的网站，用你设置的管理员用户登录；

  2. 【启用用户注册前，配置好邮件服务】{可以使用宝塔邮局的smtp设置（25端口）}

  3. 如果不会设置宝塔面板邮局，请搜索相关教程。

  4. 配置你的代理节点 {参见官方文档}

  5. 起飞吧

6 个赞
🎖 徽章申请专用帖 🎖
2

鸡场主的福音。

3

好细致 :xhj16:

1 个赞
4

感谢分享

5

感谢分享

6

感谢分享

7

谢谢分享

1 个赞
8

大佬真好