Stellar 配置生成器

基本信息

外观

客户端下载

API 连接

生成文件

基本信息

站点名称、部署路径、自定义代码

路由基础路径

路由基础路径取决于你的部署方式：
• 根目录部署（如 https://example.com/）→ 填写 /
• 子目录部署（如 https://example.com/stellar/）→ 填写 /stellar/（必须以 / 开头和结尾）

路由基础路径 (routerBase)

根目录部署填 /；子目录部署必须以 / 开头和结尾，例如 /stellar/

站点标题 (title)

浏览器标签标题、侧边栏品牌名称

站点简介 (description)

页面描述或品牌说明

静态资源路径 (assets_path)

一般保持默认 /assets

版本号 (version)

前端展示的主题版本号

自定义 Head 代码 (header_code)

注入到 <head> 标签尾部，支持 <script>、<style>、<link> 等

自定义页脚代码 (footer_code)

在页面底部渲染，可放置版权信息、统计代码等

主题与 Logo

颜色、标识、落地页

主题主色 (theme.color)

default 使用项目默认配色

品牌 Logo URL (logo)

留空使用默认图标或文字标识

落地页主题 (landing_theme_mode)

落地页默认深色或浅色

落地页开关 (landing_page_enabled)

开启后访问首页显示落地页，关闭则直接跳转登录/仪表盘

已启用 ON

社交与联系

群组、客服

Telegram 群组 (telegram_group)

完整 URL；留空时从后端配置读取，仍为空则隐藏入口

API 错误联系信息 (api_error_contact)

API 全部检测失败时展示的联系方式；留空使用默认文案

全站背景

图片 / 视频

启用全站背景 (background.enabled)

开启后背景媒体会覆盖整个视口

已禁用 OFF

旧版 auth 页背景 (background_url)

仅当上方全站背景未启用时生效，作为登录/注册/忘记密码页的独立背景图。留空使用默认。

文档中心

知识库侧边栏样式

分类侧边栏样式 (knowledge_sidebar_style)

nav（推荐） = 上下导航式：顶部上一项 + 中间当前分类大卡片 + 底部下一项 + 紧凑分类网格
list = 平铺列表式：所有分类一直展开显示

毛玻璃效果

Glassmorphism

启用毛玻璃 (glassmorphism.enabled)

所有卡片应用毛玻璃效果

已禁用 OFF

客户端下载链接

留空则不显示该平台入口

Windows

macOS

Android

iOS

Linux

路由器

API 连接配置

后端地址、检测、代理

URL 获取模式 (url_mode)

static（推荐） = 从固定地址列表中选取后端，适合多节点或跨域部署
auto = 根据前端域名自动拼接后端地址，适合前后端同域部署

后端 API 地址列表 (static_base_urls)

支持添加多个地址。开启健康检测后将自动选择可用节点，实现故障自动转移。

健康检测 (check_enabled)

开启后页面加载时检测后端可用性，自动切换至可用节点。
配置了多个后端地址时强烈建议开启，实现故障自动转移。

已启用 ON

健康检测接口路径 (check_path)

后端健康检测接口的路径，通常保持默认值即可

后端类型 (backend_type)

用于适配不同后端项目的 API 差异：
xboard = cedar2025/Xboard（支持魔法链接登录、礼品卡完整模块、Turnstile 验证码等）
v2board = wyx2685/v2board 及兼容的原版 v2board（支持工单提现、流量提前重置、解绑 Telegram 等）
auto = 自动探测（首次请求 guest/comm/config 后根据字段判断，无法判断时按 xboard 处理）

代理配置

正向代理 / 反向代理说明

正向代理 vs 反向代理

正向代理（Forward Proxy） — 在本配置文件中设置

前端通过一个中转服务器转发 API 请求，用于解决 CORS 跨域限制 或 内网穿透 问题。

示例：前端 https://front.example.com 需要访问后端 https://back.internal.com（非同域且后端未配置 CORS），可通过正向代理中转请求，避免浏览器跨域拦截。

反向代理（Reverse Proxy） — 在 Nginx / Caddy 等 Web 服务器中设置

由 Nginx / Caddy 等 Web 服务器在服务端配置，将同一域名下的请求按路径分发到不同后端。

示例：通过 https://example.com/api/ 访问后端，https://example.com/ 访问前端静态文件。此配置在 Nginx 配置文件中设置，不在本文件中设置。

启用正向代理 (proxy_enabled)

仅在遇到 CORS 跨域问题或需要内网穿透时启用。通常保持禁用。

已禁用 OFF

生成的配置文件

env.js

env.js public/env.js

// 点击「重新生成」或填写完其他标签页后切换到此处，即可看到生成的配置内容。