跳到主要内容

快速开始

五分钟搭起一个能用的皮肤站。正式上线前再看部署方式与反向代理与 HTTPS。

1. 启动​

有 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:从 Releases 下载对应系统的压缩包,解压后运行:

  • Windows:双击 start.bat
  • macOS:双击 start.command(被系统拦截时右键 → 打开)
  • Linux:./start.sh

发行包自带运行环境,不需要另外安装任何东西。

2. 完成安装​

首次启动时,日志里会打印一条一次性安装链接。Windows 和 macOS 的发行包会自动在浏览器里打开它;Docker 和 Linux 在日志里找:

docker compose logs skinloom | grep setup # Docker;发行包看启动窗口

打开 http://服务器地址:17546/setup?token=…,验证身份后可在向导中选择 全新安装、从 Blessing Skin 迁移 或 从 SkinLoom 备份恢复,图形化配置数据库(SQLite / MySQL / PostgreSQL)、材质存储(本地目录 / 阿里云 OSS / 腾讯云 COS / Cloudflare R2 / MinIO)与反向代理识别,并即时测试连通性与写入权限。向导首次启动前不会提前生成空白数据库或配置文件;链接 24 小时内有效,用过即作废,找不到时运行 skinloom setup-link 重新生成(Docker 里是 docker compose exec skinloom /app/skinloom setup-link)。

只有能看到日志的人才能完成安装,所以公网部署也不会被别人抢先。

3. 接下来​

要做的事去看
绑定域名、开启 HTTPS反向代理与 HTTPS
配置邮件(验证邮箱、找回密码需要)注册、登录与邮件
调整积分、上传规则、角色名规则站点设置
换主题、编辑首页外观与主题
开机自启、后台常驻发行包与系统服务 或 Docker Compose
从 Blessing Skin 搬过来从 Blessing Skin 迁移

记住这三件事​

  • 端口:只需要开放 17546。
  • 数据:数据库、配置、密钥、上传的文件都在数据目录(Docker 里是 /data 卷,发行包里是 data/)。备份就是备份这个目录。
  • 升级:换新版本后重启即可,数据库会自动迁移。