SSPanel-Uim-Docker

下载源代码

git clone --recurse-submodules --depth=1 https://github.com/du5/SSPanel-Uim-Docker && cd SSPanel-Uim-Docker
# git submodule update --remote # 可选, 拉取 SSPanel-Uim 最新代码

安装 PHP 依赖

# rm -rf SSPanel-Uim/vendor SSPanel-Uim/composer.lock # 可选, 删除旧依赖重新安装
docker run --rm -v $PWD/SSPanel-Uim:/app composer install --ignore-platform-reqs

启动

# 数据库文件位置 /opt/data/mysql
# 时区 Asia/Shanghai
# 可通过 docker-compose.yaml 配置文件修改
docker-compose up -d

创建数据库

docker-compose exec -i mariadb sh -c 'exec mariadb -uroot -p"$MARIADB_ROOT_PASSWORD" -e"\
SET NAMES utf8;
CREATE DATABASE sspanel CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"'

复制配置文件

cp SSPanel-Uim/config/.config.example.php SSPanel-Uim/config/.config.php
cp SSPanel-Uim/config/appprofile.example.php SSPanel-Uim/config/appprofile.php
# 修改配置文件，数据库地址为 mariadb
# pma 访问地址 http://<当前ip>:888
# 主机名 mariadb 用户 root
# 密码查看或修改请通过 docker-compose.yaml 文件
sed -i "s|\\$_ENV['db_host']      = '';|\\$_ENV['db_host']      = 'mariadb';|" SSPanel-Uim/config/.config.php # 修改数据库 host
# vim SSPanel-Uim/config/.config.php # 修改其他配置文件

设置 php 权限

docker-compose exec -i php sh -c 'exec chmod -R 755 `pwd`'
docker-compose exec -i php sh -c 'exec chown -R www-data: `pwd`'

创建管理员并同步用户

docker-compose exec -i php sh -c 'exec php xcat Migration new' # 导入全新数据库至最新版本
docker-compose exec -i php sh -c 'exec php xcat Tool importSetting' # 导入数据库配置
docker-compose exec -i php sh -c 'exec php xcat Tool createAdmin' # 创建管理员
docker-compose exec -i php sh -c 'exec php xcat ClientDownload' # 更新客户端
docker-compose exec -i php sh -c 'exec php xcat Tool resetBandwidth' # 重置用户流量

wget https://github.com/du5/geoip/raw/refs/heads/main/GeoLite2-City.mmdb -P SSPanel-Uim/storage/GeoLite2-City # 下载 GeoLite2-City.mmdb
wget https://github.com/du5/geoip/raw/refs/heads/main/GeoLite2-Country.mmdb -P SSPanel-Uim/storage/GeoLite2-Country # 下载 GeoLite2-Country.mmdb

配置定时任务

*/5 * * * * docker-compose exec -i php sh -c 'exec php xcat Cron'

停止面板(跑路)

# 在项目根目录下执行
docker-compose down
# 该命令不会删除数据库, 如需删库跑路需要额外执行下一条命令
# rm -rf /opt/data/mysql

迁移备份&还原数据库

# 备份 sspanel 数据库, 执行完后文件位于 ./SSPanel-Uim/db/db.sql
docker-compose exec mariadb sh -c 'exec mariadb-dump sspanel -uroot -p"$MARIADB_ROOT_PASSWORD"' > db.sql

# 移动备份文件到 SSP 项目中的 sql 目录
mv db.sql SSPanel-Uim/sql/

# 建表&导入数据库
docker-compose exec -i mariadb sh -c 'exec mariadb -uroot -p"$MARIADB_ROOT_PASSWORD" -e"
SET NAMES utf8;
CREATE DATABASE sspanel CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
use sspanel;
source /tmp/sql/db.sql;"'