跳到主要内容

Docker Compose(推荐)

仓库的 deploy/compose/ 里有三份现成的 compose 文件:

目录容器适合
minimal1 个(前后端一体),SQLite个人站、中小站、NAS
standard后端、前端、MariaDB中大站,前端可多开
postgres后端、前端、PostgreSQL同上,用 PostgreSQL

所有容器都设置了 restart: unless-stopped:Docker 开机自启后,站点随之启动;崩溃后自动重启。

最小部署​

mkdir skinloom && cd skinloom
curl -fsSLO https://raw.githubusercontent.com/Entropy-Increase-Team/skinloom/main/deploy/compose/minimal/compose.yaml
docker compose up -d
docker compose logs skinloom | grep setup # 一次性安装链接

打开 http://服务器地址:17546,按安装链接完成初始化。

前后端分离 + MariaDB / PostgreSQL​

mkdir skinloom && cd skinloom
base=https://raw.githubusercontent.com/Entropy-Increase-Team/skinloom/main/deploy/compose/standard # PostgreSQL 用 …/postgres
curl -fsSLO $base/compose.yaml && curl -fsSL $base/.env.example -o .env
sed -i "s/^DB_PASSWORD=.*/DB_PASSWORD=$(openssl rand -hex 24)/" .env
docker compose up -d
docker compose logs server | grep setup

后端是唯一入口,它把页面请求转给前端容器(web.mode = external)。前端无状态,可以多开:

docker compose up -d --scale web=2

可调的变量(写进 .env 或命令前)​

变量默认说明
SKINLOOM_VERSIONlatest镜像版本:0.1.0 这样的正式版本、latest(最新发布)或 edge(main 分支最新构建)
SKINLOOM_PORT17546宿主机端口
TZAsia/Shanghai时区
DB_PASSWORD—数据库密码(standard、postgres 必填)

其它配置用 SKINLOOM_<段>__<键> 环境变量加到服务的 environment 里,例如放在反向代理后面时的 SKINLOOM_SERVER__TRUSTED_PROXIES。

日常操作​

docker compose pull && docker compose up -d # 升级
docker compose logs -f # 看日志
docker compose exec skinloom /app/skinloom setup-link # 重新生成安装链接(minimal)
docker compose exec server /usr/local/bin/skinloom setup-link # 同上(standard / postgres)

备份与迁移​

最小部署的全部数据都在 skinloom_data 卷里:

docker compose stop
docker run --rm -v skinloom_data:/data -v "$PWD":/backup alpine tar czf /backup/skinloom-data.tgz -C /data .
docker compose start

恢复时把压缩包解回同名卷即可。standard、postgres 还要备份数据库卷 skinloom_db(或用 mariadb-dump / pg_dump)。

还没有发布版本时:从源码构建​

git clone https://github.com/Entropy-Increase-Team/skinloom && cd skinloom
docker compose -f deploy/compose/minimal/compose.yaml up -d --build

compose 文件同时写了 image 与 build:能拉到镜像时直接用镜像,拉不到时用仓库源码构建。