跳到主要内容

站点设置

站点名称、注册、积分、上传规则等都是站点设置:保存在数据库里,改了立即生效,已打开的页面几秒内自动刷新,不需要重启。

怎么改​

后台:管理员进入"后台 → 设置",按分组修改,每组单独保存。数字有上下限,填错时页面直接提示。

命令行(在服务器上,值是 JSON):

skinloom settings get # 列出全部(* 表示改过)
skinloom settings set score.initial 500
skinloom settings set site.name '{"zh-CN":"我的皮肤站","en":"My Skins"}'
skinloom settings set site.name null # 恢复默认

接口:PATCH /api/v1/admin/settings,用管理员登录状态或 skinloom admin token 输出的令牌。

几点说明:

  • 密码和密钥类设置只写不读:保存后后台只显示"已设置"。
  • 多语言的设置(站点名、公告等)是 {"zh-CN": "…", "en": "…"} 这样的对象。
  • 每次修改都记入审计日志。

速查表​

站点​

键默认说明
site.name / site.description云织 / 开源、自托管的 Minecraft 皮肤站站点名称与简介(多语言)
site.url空站点的公开地址,如 https://skins.example.com。一定要设置:邮件链接、第三方登录回调、外置登录都依赖它。安装向导会自动填写
site.announcement空首页与用户中心的公告(多语言,Markdown)
site.timezoneAsia/Shanghai时区:决定每日签到的刷新时间和后台统计的日期
site.logo / site.favicon空Logo 与浏览器图标的地址,空表示用主题自带的
site.copyright空页脚文字(多语言,Markdown)
seo.keywords空给搜索引擎的关键词(多语言,逗号分隔)

注册与登录​

键默认说明
auth.registrationopenopen 开放注册,closed 关闭
auth.registrations_per_ip3同一地址 24 小时内最多注册几个账号,0 不限
auth.login_captcha_after3登录失败几次后要求验证码,0 每次都要
auth.require_email_verificationfalse开启后,未验证邮箱的账号不能创建角色、上传或修改材质、举报、创建应用与令牌、在启动器登录
auth.social.providers[]第三方登录,见第三方登录
captcha.providerimage验证码:image(内置)、turnstile、recaptcha、hcaptcha、none
captcha.<提供方>.site_key / .secret_key空第三方验证码的密钥

详见注册、登录与邮件。

邮件​

键默认说明
mail.drivernonenone 不发邮件、smtp、log(只写进日志,测试用)
mail.from空发件人,如 云织 <noreply@skins.example.com>
mail.smtp.host / .port空 / 465SMTP 服务器
mail.smtp.username / .password空SMTP 账号(很多邮箱要用"授权码")
mail.smtp.encryptiontlstls(465 端口)、starttls(587)、none(仅限本机)

积分​

键默认说明
score.initial1000新账号的积分
score.per_storage / score.private_per_storage1 / 10上传公开 / 私有材质每 KB 消耗的积分
score.per_closet_item0每个衣柜条目消耗的积分(收藏、上传都算)
score.award_per_texture0上传公开材质的奖励
score.award_per_like0材质被别人收藏时上传者得到的积分
score.per_player100创建一个角色消耗的积分
score.return_on_deletetrue删除角色、移出衣柜、删除材质时退还当时花的积分
score.sign_min / score.sign_max10 / 100签到随机获得的积分
score.sign_gap_hours24两次签到至少间隔几小时
score.sign_dailyfalse改为每天签到一次(按 site.timezone 的零点)
score.reporter_modification0举报时的积分变化:负数是举报费(成立后退还),正数是奖励(驳回时收回)
score.reporter_reward0举报成立时额外奖励

材质​

键默认说明
texture.max_size_kb1024上传文件最大多少 KB(上限 8192)
texture.max_width2048图片最大宽度(像素,上限 2048)
texture.name_regexp空材质名称必须匹配的正则表达式
texture.allow_downloadtrue允许下载原图(/raw/<编号>)
texture.private_status403别人访问私有材质时返回 403 还是 404(不透露存在)
texture.content_policy空上传页显示的内容政策(多语言,Markdown)

角色与游戏接口​

键默认说明
player.name_ruleofficial角色名规则:official(字母、数字、下划线)、cjk(再加汉字)、utf8(除空格外任意字符)、custom
player.name_regexp空custom 规则的正则表达式
player.name_length_min / _max3 / 16角色名长度(上限 32)
delivery.profile_cache_seconds60游戏客户端和 CDN 缓存角色数据多少秒
delivery.missing_player_status404角色不存在时 CustomSkinLoader 接口返回 404 还是 204(让客户端继续试下一个皮肤站)

外置登录​

键默认说明
yggdrasil.uuid_algorithmv3新角色的 UUID:v3 与离线服相同(由名字算出,改名会变),v4 随机(改名不变)
yggdrasil.token_valid_seconds259200启动器登录的有效期(3 天)
yggdrasil.token_refresh_seconds604800签发后多久内过期的登录还能自动续期(7 天)
yggdrasil.tokens_per_user10每个账号最多同时登录几个启动器
yggdrasil.search_profile_max5按名字批量查角色时一次最多几个
yggdrasil.skin_domains空另外允许游戏加载皮肤的域名(逗号分隔);站点和 storage.public_url 的域名自动包含
yggdrasil.enable_alitrue页面带 X-Authlib-Injector-API-Location 头,启动器只填站点地址就能找到接口

开放平台​

键默认说明
oauth.access_token_ttl_seconds86400应用的访问令牌有效期(1 天)
oauth.refresh_token_ttl_seconds2592000刷新令牌多久不用就失效(30 天)

外观与插件市场​

键默认说明
theme.activedefault当前主题
theme.settings{}主题设置项,按主题 id 分开存储
theme.overrides{}颜色与圆角覆盖
home.blocks空首页区块,空表示用主题自带的首页
i18n.overrides{}改写的界面文字
theme.custom_css / theme.custom_js空自定义 CSS / JavaScript(各最多 64 KB,只有超级管理员能改)
theme.trusted_web[]超级管理员显式允许执行前端脚本(web/index.js,Level ⑤ 组件覆盖)的本地未签名主题 ID 列表
plugins.trusted_keys[]受信的插件/主题作者 Ed25519 公钥(PEM 格式,每行一个,只有超级管理员能改;校验 .slp 包签名时使用)
plugin.registries官方源(主备双镜像:registry.skinloom.cn + GitHub dist)插件与主题市场源列表(JSON 数组:[{id, name, urls, publicKey, official, enabled}],只有超级管理员能改;官方源始终强制校验宿主内置的官方 Ed25519 公钥)

见外观与主题和插件与主题。

CDN 刷新​

键默认说明
cdn.providernonenone、cloudflare、aliyun、tencent、webhook
cdn.base_url空CDN 对外的站点地址,空表示用 site.url
cdn.cloudflare.*、cdn.aliyun.*、cdn.tencent.*、cdn.webhook.*空各提供方的凭据

见备份、恢复与 CDN。