SSPanel-UIM 前端搭建教程（使用 aaPanel-宝塔面板）

一、前言

网上关于 ss-panel 安装教程已经很多了，有些不完整或者是不够详细，导致出现教材没提到的报错的时候就不知道怎么办了，我会把新手可能碰到的所有问题都写进来，如果有不完善的地方 欢迎评论反馈。

二、界面预览

三、软件简介和特性

SSPanel UIM 是一款专为 Shadowsocks / ShadowsocksR / V2Ray / Trojan 设计的多用户管理面板，基于 ss-panel-v3-mod 开发。

• 集成支付宝当面付，PAYJS，Paymentwall 等多个支付系统
• 重构面板首页、节点列表、商品列表
• 新增 SPA（Single Page Apps）版 UI
• 商品增加同时连接设备数，用户限速属性
• 新用户注册现金奖励、用户常规端口切换与指定
• 公共库文件加载使用 jsDelivr
• 支持 V2Ray & Trojan
• 性能优化，程序逻辑改善，代码质量修正
• 更多新功能写不下了

四、运行环境

SSPanel UIM 的需要以下程序才能正常的安装和运行：

• Git
• PHP 8.1+
• Composer
• MariaDB 10.8
• SSPanel UIM 支持安装在 LNMP、CloudPanel 等集成环境中。

在正式安装前可以用 ls /usr/bin/composer 来检查下环境是否都准备好了，宝塔是默认安装过 composer 的

报错的话注意升级下试试 composer selfupdate

当然如果还是不行可以排查下是不是默认 php 版本不对

#修改默认PHP版本
rm -f /usr/bin/php # 删除默认配置
ln -sf /www/server/php/80/bin/php /usr/bin/php # 修改成正在使用的配置

五、开始安装

（一）使用宝塔创建站点和数据库

省略，不会的话不用看下去了。

（二）环境准备

2.1 拉取源码

#拉取源码
mkdir /www/wwwroot/sspanel && cd /www/wwwroot/sspanel

# 这里的 2023.3 代表的是 SSPanel UIM 的版本
# 你可以在 Release 页面中查看当前的最新稳定版本或者是输入 dev 使用开发版
# 请注意，dev 分支可能在使用过程中出现不可预知的问题。
git clone -b 2023.3 --depth=1 https://github.com/Anankke/SSPanel-Uim.git tmp && mv tmp/.git . && rm -rf tmp && git reset --hard

# 下载 dev 分支(存在很多未知的bug)
git clone -b dev https://github.com/Anankke/SSPanel-Uim.git tmp && mv tmp/.git . && rm -rf tmp && git reset --hard

#如果找不到git
yum -y install git #Centos
apt-get install git #Debain

2.2 添加伪静态规则

location /{
    try_files $uri /index.php$is_args$args;
}

2.3 更改网站目录

将网站目录的运行目录改为 public，并关闭防跨站。

2.4 删除禁用函数

进入软件商店 - php 设置 - 禁用函数中，删除掉这几个函数

popen、proc_open、putenv、system、proc_get_status

安装 fileinfo 扩展（小于1G扩充虚拟内存）

（三）安装SSpanel面板

cd /www/wwwroot/sspanel
cp config/.config.example.php config/.config.php
cp config/appprofile.example.php config/appprofile.php
wget https://getcomposer.org/installer -O composer.phar
php composer.phar

#忽略版本参数--ignore-platform-reqs
php composer.phar install

chmod 755 -R *
chown www -R *
git config --global --add safe.directory $(pwd)
git checkout .

（四）数据库创建

使用宝塔创建站点的时候创建了数据库的话，跳过数据库创建步骤。

#登录数据库，密码在宝塔面板-数据库查看root密码
mysql -uroot -p

#创建数据库，sspanel为默认数据库名，请与配置文件数据库名保持一致
create database sspanel;

#Ctrl + D登出数据库

（五）修改配置文件

#编辑.config.php
vi config/.config.php
#找到下列字段，进行修改
//基本设置--------------------------------------------------------------------------------------------
$_ENV['key']        = '1145141919810';  //请务必修改此key为随机字符串
$_ENV['pwdMethod']  = 'bcrypt';         //密码加密 可选 md5, sha256, bcrypt, argon2i, argon2id（argon2i需要至少php7.2）
$_ENV['salt']       = '';               //推荐配合 md5/sha256， bcrypt/argon2i/argon2id 会忽略此项

$_ENV['debug']      = false;                  //正式环境请确保为 false
$_ENV['appName']    = 'SSPanel-UIM';          //站点名称
$_ENV['baseUrl']    = 'https://sspanel.host'; //站点地址，不要写http://
$_ENV['muKey']      = 'NimaQu';               //用于校验魔改后端请求，可以随意修改，但请保持前后端一致，否则节点不能工作！

$_ENV['db_driver']    = 'mysql';
$_ENV['db_host']      = '';            //数据库地址
$_ENV['db_socket']    = '';            //可留空
$_ENV['db_database']  = 'sspanel';     //数据库名，可自定义
$_ENV['db_username']  = 'root';        //数据库用户名，建议root
$_ENV['db_password']  = 'sspanel';     //用户名对应的密码，在宝塔面板数据库里查看

（六）其他配置

#执行如下站点初始化设置

#数据库初始化，2022.12.0.1之前的版本（含）
mv db/migrations/20000101000000_init_database.php.new db/migrations/20000101000000_init_database.php
vendor/bin/phinx migrate

#数据库初始化，2022.12.0.1之后的新版本（不含）
php xcat Migration new 

php xcat Tool importAllSettings #导入配置项目
php xcat Tool createAdmin #创建管理员账户
php xcat ClientDownload
php xcat Update

#php xcat Update 执行不了就用这个 bash update.sh

#添加计划任务
#注：2023.02之后的版本，xcat Job CheckJob 已经被合并至 xcat Cron 中，不再需要xcat Job CheckJob计划任务
#使用如下计划任务即可：
*/5 * * * * php /www/wwwroot/sspanel/xcat  Cron

crontab -e
#按i进入输入模式，将下面任务里 /www/wwwroot/sspanel 改为你的网站目录，然后替换进去
echo "*/1 * * * * php /www/wwwroot/sspanel/xcat Job SendMail
*/1 * * * * php /www/wwwroot/sspanel/xcat Job CheckJob
0 */1 * * * php /www/wwwroot/sspanel/xcat Job UserJob
30 23 * * * php /www/wwwroot/sspanel/xcat SendDiaryMail
0 0 * * *   php -n /www/wwwroot/sspanel/xcat Job DailyJob" >> crontab.list

#每20分钟备份1次（可选）
*/20 * * * * php -n /www/wwwroot/sspanel/xcat backup

#检测被墙（可选）
*/1 * * * * php /www/wwwroot/sspanel/xcat detectGFW

#如果要用到 radius添加以下任务（可选）
*/1 * * * * php /www/wwwroot/sspanel/xcat synclogin
*/1 * * * * php /www/wwwroot/sspanel/xcat syncvpn
*/1 * * * * php -n /www/wwwroot/sspanel/xcat syncnas

#财务报表（可选）
5 0 * * * php /www/wwwroot/sspanel/xcat FinanceMail day 
6 0 * * 0 php /www/wwwroot/sspanel/xcat FinanceMail week
7 0 1 * * php /www/wwwroot/sspanel/xcat FinanceMail month
#输入完之后按 esc，然后输入:wq，按回车保存并退出

（七）备注

备注：如果依赖安装不上可以执行以下几句

rm -rf vendor
rm -f composer.lock
composer install

至此，前端面板就安装就完成了，如需后端安装 / 对接，请移步以下教程

搭建过程中出现任何问题欢迎留言。