✨ SubWeb

优雅的 Subconverter 订阅转换前端

🌐 在线演示 • 🚀 快速开始 • 📦 部署方式 • ☁️ Cloudflare Pages 部署

---

📖 项目简介

SubWeb 是一个轻量的 Vue 3subconverter 前端，帮助用户生成 Clash、Surge、Quantumult X 等客户端的订阅链接。

本项目 Fork 自 stilleshan/subweb，在原版基础上修复了一些 BUG 并进行了功能增强。

✨ 特性亮点

• 🎨 现代化界面 — 原生 Vue 3 响应式界面，支持键盘操作与深色模式
• ☁️ Cloudflare 原生支持 — 新增 Cloudflare Pages/Workers 部署方案，无需服务器
• 🔗 可配置的短链接 — 默认关闭；部署者可按需配置自己的短链接服务
• 🐳 Docker 一键部署 — 支持 x86 与 ARM 架构，快速上线
• ⚙️ 高度可配置 — 支持自定义后端 API、远程配置、站点名称等

---

🧩 相关项目

项目	说明
Aethersailor/subweb	📌 本项目 — 订阅转换前端
Aethersailor/SubConverter-Extended	🔗 配套改进型后端服务，支持更多功能
Aethersailor/cf-shortlink-worker	🔗 配套短链接服务，Cloudflare Workers 部署
Aethersailor/Custom_OpenClash_Rules	📜 自定义 OpenClash 分流规则

---

🚀 快速开始

在线体验

访问演示站点，立即体验订阅转换功能：

👉 https://sub.asailor.org

---

📦 部署方式

方式一：Cloudflare Pages（推荐）

全套服务均可部署于 Cloudflare 云端，无需服务器或 VPS

详细教程请参阅 → DEPLOY_CLOUDFLARE.md

简要步骤：

1. Fork 本项目到你的 GitHub 账号
2. 在 Cloudflare Pages 中连接你的仓库
3. 设置构建命令为 npm run build，输出目录为 dist
4. 通过环境变量自定义配置（可选）

---

方式二：Docker 部署

🟢 本地快速部署

docker run -d --name subweb --restart always \
-p 18080:80 \
aethersailor/subweb:latest

访问：http://127.0.0.1:18080

🔧 自定义配置部署

挂载配置目录，实现自定义站点名称、后端 API、短链接服务等：

docker run -d --name subweb --restart always \
-p 18080:80 \
-v /your/path/conf:/usr/share/nginx/html/conf \
-e API_URL='https://api.example.com' \
-e SITE_NAME='我的订阅转换' \
aethersailor/subweb:latest

未传入环境变量时，启动脚本只会在挂载目录缺少 config.js 时写入默认配置；已有配置不会被覆盖。传入 API_URL、SITE_NAME、SHORT_URL 或 ENABLE_SHORT_URL 时，会在每次启动时原子地重新生成配置，环境变量修改可稳定生效。

镜像同时发布 linux/amd64 与 linux/arm64。镜像只负责提供静态前端，不会在运行服务器上编译；构建由 GitHub Actions 完成。

镜像同步发布到 Docker Hub（aethersailor/subweb:latest）和 GitHub Container Registry（ghcr.io/aethersailor/subweb:latest），可任选其一使用。正式版本发布后，也可将 latest 替换为对应的 v* 版本标签。

💡 推荐：使用 Nginx 反向代理并配置 HTTPS

---

⚙️ 配置说明

config.js 配置文件示例：

window.config={// 网站标题siteName: 'Subconverter Web',// 后端 API 列表apiBackends: [{name: 'Aethersailor 后端',url: 'https://api.asailor.org',},{name: '肥羊增强型后端',url: 'https://api.v1.mk',},],// 短链接功能开关// 默认关闭；开启会把完整转换链接发送到短链接服务enableShortUrl: false,// 短链接服务地址shortUrl: '',// 首页菜单menuItem: [{title: '通知频道',link: 'https://t.me/custom_openclash_rules',target: '_blank',},{title: '聊天群组',link: 'https://t.me/custom_openclash_rules_group',target: '_blank',},{title: 'Custom_OpenClash_Rules',link: 'https://github.com/Aethersailor/Custom_OpenClash_Rules',target: '_blank',},],// 远程配置列表remoteConfigOptions: [{value:
'https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/refs/heads/main/cfg/Custom_Clash.ini',text: 'Aethersailor 规则 标准版',},{value:
'https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/refs/heads/main/cfg/Custom_Clash_Lite.ini',text: 'Aethersailor 规则 轻量版',},{value:
'https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/refs/heads/main/cfg/Custom_Clash_GFW.ini',text: 'Aethersailor 规则 极简版(GFW)',},{value:
'https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/refs/heads/main/cfg/Custom_Clash_Full.ini',text: 'Aethersailor 规则 重度分流版',},],};

---

🔗 致谢

本项目基于以下优秀项目进行开发：

• stilleshan/subweb — 原始项目

---

📄 开源协议

本项目基于 GPL-3.0 协议开源。

---

_{Made with ❤️ by Aethersailor}