准备#

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

• Git
• PHP 8.0+
• Composer
• MySQL / MariaDB

SSPanel UIM 支持安装在 LNMP、CloudPanel 等集成环境中。

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

报错的话，注意升级 Composer：composer selfupdate

创建一个站点#

1. 进入网站目录:

   1
   cd /www/wwwroot/你的网站目录
   

2. 拉取源码:

   1
   git clone -b 2022.9 --depth 1 https://github.com/Anankke/SSPanel-Uim.git .
   

3. 设置伪静态: (通常需要在 Nginx 配置文件中添加，根据宝塔面板具体设置而定)

   1
   location / {
   2
       try_files $uri $uri/ /index.php?$args;
   3
   }
   

4. 修改网站运行目录和关闭防跨站: (通常在宝塔面板中设置)

5. 删除禁用函数: (在宝塔面板 - PHP 设置 - 禁用函数 中删除)

   • popen
   • proc_open
   • putenv

6. 进入网站根目录:

   1
   cd /www/wwwroot/你的网站目录
   

7. 复制配置文件示例:

   1
   cp config/.config.example.php config/.config.php
   2
   cp config/appprofile.example.php config/appprofile.php
   

8. 合并 Migration 文件: (解决版本不兼容问题)

   1
   mv db/migrations/20000101000000_init_database.php.new db/migrations/20000101000000_init_database.php
   

9. 安装 Composer 依赖:

   1
   wget https://getcomposer.org/installer -O composer.phar
   2
   php composer.phar
   3
   php composer.phar install
   

10. 设置目录权限:

    1
    chmod 755 -R *
    2
    chown www -R *
    

11. Git 配置: (可选，避免无法 pull 更新)

    1
    git config --global --add safe.directory $(pwd)
    

12. 恢复 Git 状态:

    1
    git checkout .
    

修改配置文件#

编辑 config/.config.php，找到以下部分：

• db_host: 如果使用本地数据库，填写 localhost 或 127.0.0.1。如果使用云数据库，填写 IP 或域名，并注意允许服务器 IP 连接。
• db_socket: 可留空，或根据文件上方注释填写。
• 数据库账户需要有对表结构的操作权限.
• 数据库名默认是 sspanel，可修改为其他名称。但要注意后续创建数据库时，创建的库名需与在此填写的保持一致。

创建数据库#

1. 登录数据库:

   1
   mysql -uroot -p
   

2. 创建数据库:

   1
   create database 配置里填的数据库名;
   

3. 登出数据库: 按下 Ctrl + D

导入表结构#

执行数据库迁移，在网站根目录执行：

1
vendor/bin/phinx migrate

后续操作#

• 导入配置项目:

  1
  php xcat Tool importAllSettings
  

• 创建管理员账户:

  1
  php xcat Tool createAdmin
  

• 下载 IP 数据库:

  1
  php xcat Tool initQQwry
  2
  php xcat ClientDownload
  

• 设置计划任务:

  使用 crontab -e 指令设置 SSPanel 的基本 cron 任务：

  1
  */1 * * * * /usr/local/php/bin/php /path/to/your/site/xcat  Job CheckJob
  2
  0 */1 * * * /usr/local/php/bin/php /path/to/your/site/xcat  Job UserJob
  3
  0 0 * * * /usr/local/php/bin/php -n /path/to/your/site/xcat Job DailyJob
  

• 设置财务报表:

  1
  5 0 * * * /usr/local/php/bin/php /path/to/your/site/xcat FinanceMail day
  2
  6 0 * * 0 /usr/local/php/bin/php /path/to/your/site/xcat FinanceMail week
  3
  7 0 1 * * /usr/local/php/bin/php /path/to/your/site/xcat FinanceMail month
  

• 设置节点 GFW 检测:

  1
  */1 * * * * /usr/local/php/bin/php /path/to/your/site/xcat DetectGFW