自建Clash订阅转换 - Subconverter+Subweb+MyUrls搭建教程 - 全docker完成 - mihomo内核避坑指南

Author： Rui
发布时间：March 24, 2024
68931 views
40 comments
18537 words
Categories：技术

<div class="tip share">请注意，本文编写于 799 天前，最后修改于 2 天前，其中某些信息可能已经过时。</div>

> 2023年11月27日，恰逢迁移服务，对教程重新梳理更新，以下已经修改为最新版。
>
> 2024年3月24日，修改docker-compose，subconverter也自行编译，这样保持所有套件都能使用最新版。此外，修改了一些sub-web、myurls的配置
>
> 2024年10月10日，mihomo有一个subconverter，支持vless和hy2等新协议
>
> 2026年5月30日，因为服务器搬迁，重新优化了docker-compose配置

---

~~春节期间，有点时间，写个教程......~~

调整了工作岗位后，有点时间可以再调整一下

最近开始转向Clash，之前因为Clash的订阅配置实在太难搞，对于我这种不用机场的人来说，一直习惯用自己的节点，所以也就用着V2rayN挺好。但是一旦用上了Clash的分流，你真的就回不去了。

> 感谢[tindy2013](https://github.com/tindy2013)、[CareyWang](https://github.com/CareyWang)等大佬们的无私分享，才让我们现在享受如此美好的生活！
>
> 感谢https://wiki.metacubex.one/

另外，网上也有很多在线的Clash转换，但是作为愿意折腾的我，当然要用自建的啦。另外，很多人但是自己的订阅节点会不会泄露（虽然我就这就是矫情），但是多少还有有点不太放心的。所以就研究了一下关于这个自建。

> 由于这套东西的作者写的吧有点迷惑，有些地方存在很多坑，比较晦涩，而且作者已经长久不更新，有些地方真的有坑。各位准备入坑的请做好准备。

爱墨迹已经搭建好的服务长期免费使用[https://clash-converter.imgki.com](https://clash-converter.imgki.com/)/
</div>

# Clash订阅转换

把Vmess/ss等放入这里面，之后可以生成带有分流规则的Clash连接，甚至是一键导入的Clash。

![image.png](https://imgki.com/usr/uploads/2023/11/3945231308.png)

**部署整体逻辑**

- `sub-web`：前端页面
- `subconverter`：订阅转换后端
- `subconverter-mate`：MetaCubeX 版订阅转换后端
- `MyUrls`：短链接服务
- `Redis`：MyUrls 数据存储
- `Nginx Proxy Manager`：统一反向代理

我一直是习惯Docker的方式，所以以下尽量是用docker/docker-compose，下面先分别对每个组件进行安装，这里尽量采用官方image。

但是，你可以发现，github上这些项目依然是有commit的，如果你想使用最新的，那么就需要自己编译了，所以最后我是自己在本地重新编译的，果断时间过来更新一下。同时，为了方便期间，最后我直接做了一个docker-compose整合包，便于自己up/down。

```plaintext
sub.imgki.com                  -> sub-web
subconverter.imgki.com         -> subconverter
subconverter-mate.imgki.com    -> subconverter-mate
s.imgki.com                    -> MyUrls
```

目录结构

```bash
~/clash
├── docker-compose.yml
├── MyUrls
├── redis
├── subconverter
└── sub-web
```

# 搭建后端Subconverter

## docker部署

项目地址：[https://github.com/tindy2013/subconverter](https://github.com/tindy2013/subconverter)

Docker官方指引：[https://github.com/tindy2013/subconverter/blob/master/README-docker.md](https://github.com/tindy2013/subconverter/blob/master/README-docker.md)

</div>

```bash
#docker部署
docker run -d --name subcon --restart=always -p 25500:25500 tindy2013/subconverter:latest
```

```bash
#docker-compose部署
subconverter:
    image: tindy2013/subconverter:latest
    container_name: subconverter
    restart: always
    ports:
      - 25500:25500
```

这里先不涉及自己编译的问题，从官方直接拉去image，注意请使用latest。

因为前期出现过一些bug，到时会泄露节点的问题，0.81之后应该就没啥大问题了。关于编译问题此处不再讨论。

### [MetaCubeX](https://github.com/MetaCubeX)后端

```yaml
subconverter-mate:
    image: ghcr.io/metacubex/subconverter:latest
    container_name: subconverter-metacubex
    restart: always
    ports:
      - 25501:25500
```

```bash
#docker部署
docker run -d --name subconverter-metacubex --restart=always -p 25501:25500 ghcr.io/metacubex/subconverter:latest
```

## 反代服务

一般大家用的宝塔或者NMP按照正常处理反代即可。如果是用Ningx Manager Proxy添加好域名 `subapi.imgki.com`

![image.png](https://imgki.com/usr/uploads/2023/11/2425686377.png)

注意：docker的ip处理
</div>

这里有一个需要注意的地方，反代指向地址不能用127.0.0.1，因为127.0.0.1实际上并不是指向宿主机，用docker的ip地址也不行，因为和npm不再一个网络里面，**如果偷懒可以指向服务器真实ip**。如果要指向容器的ip，那么需要单独处理，因为nginx manager proxy 是自定义的网络（虽然也是bridge），但毕竟不在一个网段下。解决也很简单，就是 `把NPM加入到bridge网络中`。

也可以参考最后docker-compose的网络配置方案，两个网络，一个用于内部通信，另外一个用于和NPM通信
</div>

```bash
#把NMP加入到bridge网络中
docker network connect bridge nginx-proxy-app-1
```

![image.png](https://imgki.com/usr/uploads/2023/11/1044241228.png)

之后用 `docker inspect subcon`查看容器的ip是 `172.17.0.5`.

![image.png](https://imgki.com/usr/uploads/2023/11/1895898622.png)

之后直接访问显示File not found.就是ok了

> 2023年，不良林爆出了Subconverter安全隐患，建议尽快升级到0.81 e7380d8

# 搭建前端Subweb

项目地址：[https://github.com/CareyWang/sub-web](https://github.com/CareyWang/sub-web)
</div>

## 配置前端

如果用docker搭建，需要配置前端之后，重新build镜像。

```bash
# Clone项目到本地
git clone https://github.com/CareyWang/sub-web.git
cd sub-web

# 编辑.env配置文件
vi .env

# 修改后端地址、短链接地址
# API 后端
VUE_APP_SUBCONVERTER_DEFAULT_BACKEND = "https://subapi.imgki.com"

# 短链接后端
VUE_APP_MYURLS_API = "https://s.imgki.com/short"

# 编辑.
cd src/views
vi Subconverter.vue

#这里我直接硬编辑源文件了，原则上不建议
placeholder="爱墨迹免费提供 |  https://subapi.imgki.com/sub?"

backendOptions: [{ value: "https://subapi.imgki.com/sub?" }],
```

## 增加远端服务配置

编辑 `nano sub-web/src/config/remote-configs.js`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-5914395c1c66a138dc91ec74244c597b6" aria-expanded="true"><div class="accordion-toggle"><span style="">增加ALC4SSR的规则配置（点击展开）</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-5914395c1c66a138dc91ec74244c597b6" class="collapse collapse-content"><p></p>

```json
// 远程配置选项
export const REMOTE_CONFIGS = [
  {
    label: "universal",
    options: [
      {
        label: "No-Urltest",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/universal/no-urltest.ini"
      },
      {
        label: "Urltest",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/universal/urltest.ini"
      }
    ]
  },
  {
    label: "customized",
    options: [
      {
        label: "Maying",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/customized/maying.ini"
      },
      {
        label: "Ytoo",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/customized/ytoo.ini"
      },
      {
        label: "FlowerCloud",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/customized/flowercloud.ini"
      },
      {
        label: "Nexitally",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/customized/nexitally.ini"
      },
      {
        label: "SoCloud",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/customized/socloud.ini"
      },
      {
        label: "ARK",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/customized/ark.ini"
      },
      {
        label: "ssrCloud",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/customized/ssrcloud.ini"
      }
    ]
  },
  {
    label: "Special",
    options: [
      {
        label: "NeteaseUnblock(仅规则，No-Urltest)",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/special/netease.ini"
      },
      {
        label: "Basic(仅GEOIP CN + Final)",
        value: "https://cdn.jsdelivr.net/gh/SleepyHeeead/subconverter-config@master/remote-config/special/basic.ini"
      }
    ]
  },
  {
    label: "ACL4SSR",
    options: [
      {
        label: "ACL4SSR_Online 默认版 分组比较全 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online.ini"
      },
      {
        label: "ACL4SSR_Online_AdblockPlus 更多去广告 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_AdblockPlus.ini"
      },
      {
        label: "ACL4SSR_Online_NoAuto 无自动测速 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_NoAuto.ini"
      },
      {
        label: "ACL4SSR_Online_NoReject 无广告拦截规则 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_NoReject.ini"
      },
      {
        label: "ACL4SSR_Online_Mini 精简版 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Mini.ini"
      },
      {
        label: "ACL4SSR_Online_Mini_AdblockPlus.ini 精简版 更多去广告 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Mini_AdblockPlus.ini"
      },
      {
        label: "ACL4SSR_Online_Mini_NoAuto.ini 精简版 不带自动测速 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Mini_NoAuto.ini"
      },
      {
        label: "ACL4SSR_Online_Mini_Fallback.ini 精简版 带故障转移 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Mini_Fallback.ini"
      },
      {
        label: "ACL4SSR_Online_Mini_MultiMode.ini 精简版 自动测速、故障转移、负载均衡 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Mini_MultiMode.ini"
      },
      {
        label: "ACL4SSR_Online_Full 全分组 重度用户使用 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Full.ini"
      },
      {
        label: "ACL4SSR_Online_Full_NoAuto.ini 全分组 无自动测速 重度用户使用 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Full_NoAuto.ini"
      },
      {
        label: "ACL4SSR_Online_Full_AdblockPlus 全分组 重度用户使用 更多去广告 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Full_AdblockPlus.ini"
      },
      {
        label: "ACL4SSR_Online_Full_Netflix 全分组 重度用户使用 奈飞全量 (与Github同步)",
        value: "https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Full_Netflix.ini"
      },
      {
        label: "ACL4SSR 本地 默认版 分组比较全",
        value: "config/ACL4SSR.ini"
      },
      {
        label: "ACL4SSR_Mini 本地 精简版",
        value: "config/ACL4SSR_Mini.ini"
      },
      {
        label: "ACL4SSR_Mini_NoAuto.ini 本地 精简版+无自动测速",
        value: "config/ACL4SSR_Mini_NoAuto.ini"
      },
      {
        label: "ACL4SSR_Mini_Fallback.ini 本地 精简版+fallback",
        value: "config/ACL4SSR_Mini_Fallback.ini"
      },
      {
        label: "ACL4SSR_BackCN 本地 回国",
        value: "config/ACL4SSR_BackCN.ini"
      },
      {
        label: "ACL4SSR_NoApple 本地 无苹果分流",
        value: "config/ACL4SSR_NoApple.ini"
      },
      {
        label: "ACL4SSR_NoAuto 本地 无自动测速",
        value: "config/ACL4SSR_NoAuto.ini"
      },
      {
        label: "ACL4SSR_NoAuto_NoApple 本地 无自动测速&无苹果分流",
        value: "config/ACL4SSR_NoAuto_NoApple.ini"
      },
      {
        label: "ACL4SSR_NoMicrosoft 本地 无微软分流",
        value: "config/ACL4SSR_NoMicrosoft.ini"
      },
      {
        label: "ACL4SSR_WithGFW 本地 GFW列表",
        value: "config/ACL4SSR_WithGFW.ini"
      }
    ]
  }
];
```

![mstsc_NNHhxDHsCb.png](https://imgki.com/usr/uploads/2023/11/2068273642.png)

当然，还有其他大佬的分流规则库。

**ACL4SSR的库** :[https://github.com/ACL4SSR/ACL4SSR/tree/master/Clash](https://github.com/ACL4SSR/ACL4SSR/tree/master/Clash)

~~**blackmatrix7的库** :[https://github.com/blackmatrix7/ios_rule_script/tree/master/rule/Clash](https://github.com/blackmatrix7/ios_rule_script/tree/master/rule/Clash)~~

~~**神机规则库** :[https://github.com/DivineEngine/Profiles/tree/master/Clash/RuleSet](https://github.com/DivineEngine/Profiles/tree/master/Clash/RuleSet)~~

这里还可以自己做分流规则加入进去，但是本文不涉及了。

## 构建镜像&部署服

```bash
#构建镜像
docker build -t subweb-local:latest .

#部署服务
docker run -d -p 58080:80 --restart always --name subweb subweb-local:latest
```

# 搭建短域名Myurls

项目地址：[https://github.com/CareyWang/MyUrls](https://github.com/CareyWang/MyUrls)
</div>

~~这个的坑最多了，我也是搞了好半天在搞定的。官方原来给的搭建的方法有好几种，可以直接docker run，也可以docker-compose，或者是用go部署，但是都有问题。~~

官方发布了docker，可以直接使用，其中作者也给出了Dockerfile，你也可以自己打包镜像。这里曾经碰到很多坑，后来其实也都修复了。

## ~~作废方案~~

这个是20230121首次发布时使用的方案，比较复杂，这两天看了一下作者应该是修复了docker以及docker compose，而且期间也经历了多次修改调整。

- 如果用docker，需要修改index.html之后，重新build，但是期间go编译总是过不去，放弃
- 如果用docker-compose，还是编译过不去，放弃
- 如果按照官方直接部署可执行文件，可以正常启动，但是不是docker部署的，放弃~
- 另外还有部署到Railway，没试过

最终搞来搞去，总算是搞定了，按照下面的教程走。

1. 部署服务

```bash
#部署Redis，因为需要redis。如果是docker-compose会自己部署redis，我是直接apt update安装了。
apt update
apt install redis-server -y 
之后redis-cli测试一下

#clone项目到本地
git clone https://github.com/CareyWang/MyUrls.git MyUrls
cd MyUrls
vi public/index.html
const backend = 'https://i.2z.pw' #修改短链接域名

#部署服务
docker run -d --restart always --net=host --name myurls  -v /root/MyUrls/public:/app/public careywong/myurls:latest -domain i.2z.pw -port 8002 -conn 127.0.0.1:6379  -ttl 180

其中域名、端口按照实际修改，--net=host是为了连接宿主机redis
最关键的-v /root/MyUrls/public:/app/public把修改了index.html的目录映射到容器
```

![image.png](https://imgki.com/usr/uploads/2023/11/1427243911.png)

## 推荐方案

```bash
#clone项目到本地
git clone https://github.com/CareyWang/MyUrls.git MyUrls
cd MyUrls
vi public/index.html
const backend = 'https://s.2z.pw' #修改短链接域名

cd MyUrls
cp .env.example .env #编辑好域名、端口等配置

docker-compose up -d  #直接启动
```

### 设置反代

看你的情况，是lnmp还是NMP，或者很多教程的caddy，总之设置反代。

### 跨域设置

需要设置跨域 `Access-Control-Allow-Origin *`

```bash
#nginx配置
server {
    server_name example.com;

location / {
        add_header 'Access-Control-Allow-Origin' '*';
        proxy_pass http://127.0.0.1:8002/;
    }
}
```

我是用的自己的cdn反代，直接开启自适应即可

![chrome_SgUam46NTY.png](https://imgki.com/usr/uploads/2023/11/1407992119.png)

### get方式Url长度问题

因为get的url长度非常长，需要调整get请求长度限制。

```bash
#nginx设置
client_max_body_size 24M;
client_body_buffer_size 128k;

client_header_buffer_size 5120k;
large_client_header_buffers 16 5120k;
```

# 套装部署

近期重新梳理了一下几个套装，可以docker compose 一键启动

## 拉取相关项目

```bash
mkdir clash && cd clash

git clone https://github.com/CareyWang/sub-web.git 
cd sub-web
# 按照上述教程完成sub-web配置,.env view等文件

cd .. 
git clone https://github.com/CareyWang/MyUrls.git MyUrls
cd MyUrls
#按照上述教程完成 Myurls配置

cd..
nano docker-compose.yml
#按照以下文档编辑docker-compose.yml
```

## 配置docker-compose.yml

稍微解释一下关于 `docker-compose.yml`

注：以下仅供参考，真的不能生搬硬套，给大家一个思路。
</div>

```bash
#20260530修改
services:
  subconverter:
    image: tindy2013/subconverter:latest
    container_name: clash-subconverter
    restart: unless-stopped

ports:
      - "127.0.0.1:25500:25500"

mem_limit: 256m
    memswap_limit: 256m
    cpus: "0.5"
    pids_limit: 100

networks:
      - clash-net
      - webser

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

subconverter-mate:
    image: ghcr.io/metacubex/subconverter:latest
    container_name: clash-subconverter-mate
    restart: unless-stopped

ports:
      - "127.0.0.1:25501:25500"

mem_limit: 256m
    memswap_limit: 256m
    cpus: "0.5"
    pids_limit: 100

networks:
      - clash-net
      - webser

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

subweb:
    build:
      context: ./sub-web
    container_name: clash-sub-web
    restart: unless-stopped

env_file:
      - ./sub-web/.env

ports:
      - "127.0.0.1:5080:80"

depends_on:
      - subconverter
      - subconverter-mate
      - myurls

mem_limit: 256m
    memswap_limit: 256m
    cpus: "0.5"
    pids_limit: 100

networks:
      - clash-net
      - webser

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

myurls:
    build:
      context: ./MyUrls
    container_name: clash-myurls
    restart: unless-stopped

ports:
      - "5081:8080"

volumes:
      - ./MyUrls/logs:/app/logs

depends_on:
      myurls-redis:
        condition: service_healthy

entrypoint:
      - /app/myurls
      - -domain
      - s.imgki.com
      - -conn
      - myurls-redis:6379
      - -proto
      - https
      - -port
      - "8080"

mem_limit: 256m
    memswap_limit: 256m
    cpus: "0.5"
    pids_limit: 100

networks:
      - clash-net
      - webser

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

myurls-redis:
    image: redis:7-alpine
    container_name: clash-myurls-redis
    restart: unless-stopped

command:
      - redis-server
      - --appendonly
      - "yes"
      - --appendfsync
      - everysec
      - --maxmemory
      - 128mb
      - --maxmemory-policy
      - allkeys-lru

volumes:
      - ./redis/data:/data

expose:
      - "6379"

mem_limit: 192m
    memswap_limit: 192m
    cpus: "0.3"
    pids_limit: 80

healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 10s

networks:
      - clash-net

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

networks:
  clash-net:
    driver: bridge

webser:
    external: true
```

## subconverter

这是原版订阅转换服务。

使用镜像 tindy2013/subconverter:latest。

本机访问端口是 25500。

它绑定在 127.0.0.1 上，所以外网不能直接访问，只能本机或反向代理访问。

## subconverter-mate

这是 MetaCubeX 版本的订阅转换服务。

使用镜像 ghcr.io/metacubex/subconverter:latest。

本机访问端口是 25501。

容器内部仍然使用 25500 端口，只是映射到宿主机的 25501。

这个版本通常更适合 Clash Meta / Mihomo。

## subweb

这是订阅转换的网页前端。

它从本地的 ./sub-web 目录构建镜像。

本机访问端口是 5080。

它依赖 subconverter、subconverter-mate 和 myurls。

也就是说，前端页面会配合这些后端服务使用。

## myurls

这是短链接服务。

它从本地的 ./MyUrls 目录构建镜像。

它会连接 Redis，并使用 s.imgki.com 作为短链接域名。

生成的链接协议是 https。

需要注意的是，当前 myurls 的 5081 端口是直接暴露到公网的。

如果不想让公网直接访问，建议绑定到 127.0.0.1，或者只通过反向代理访问。

## myurls-redis

这是 Redis 数据库，给 myurls 存储短链接数据。

它只在 Docker 内部网络中使用，没有暴露到公网。

Redis 开启了 AOF 持久化，数据会保存到 ./redis/data。

Redis 设置了最大内存 128MB，超过后会使用 LRU 策略删除旧数据。

如果短链接数据很重要，这个策略可能会导致旧链接失效。

## 网络说明

配置里有两个网络。

clash-net 是内部网络，用于这些服务之间互相通信。

webser 是外部网络，通常给 Nginx、Caddy、Traefik 这类反向代理使用。

webser 必须提前创建，否则启动会失败。

## 端口说明

subconverter 本机端口是 25500。

subconverter-mate 本机端口是 25501。

subweb 本机端口是 5080。

myurls 端口是 5081，并且当前可能公网可访问。

Redis 不对外暴露。

## 资源限制

大部分服务限制为 256MB 内存、0.5 个 CPU、100 个进程。

Redis 限制为 192MB 内存、0.3 个 CPU、80 个进程。

这样可以防止容器占用过多服务器资源。

## 日志限制

每个容器的 Docker 日志最多保留 3 个文件，每个文件最大 10MB。

这样可以避免日志无限增长占满磁盘。

## 启动顺序

Redis 先启动。

Redis 健康后，myurls 启动。

然后 subweb 会在 subconverter、subconverter-mate、myurls 启动后再启动。

不过 subweb 的依赖只保证启动顺序，不保证后端服务已经完全可用。

## 主要注意点

myurls 当前端口可能暴露公网，需要确认是否符合预期。

Redis 的 allkeys-lru 策略可能会删除旧短链接。

webser 网络需要提前创建。

使用 latest 镜像可能会因为自动更新导致行为变化，生产环境建议固定版本。

整体来说，这份配置适合搭建一个带短链接功能的订阅转换服务，并通过反向代理对外提供访问。

Last modification：May 30, 2026

如果觉得我的文章对你有用，请随意赞赏

40 comments

cogo
February 24th, 2025 at 11:33 pm

大佬，短链接单独可以使用，配合前端就获取失败咋回事啊！我是宝塔

Reply
1. Rui
  February 28th, 2025 at 08:35 am
  
  @cogo
  
  前端到短连接的配置有问题。
  
  Reply
ku
January 3rd, 2025 at 04:26 pm

请问这个在哪里改或者添加呢
const backend = 'https://s.2z.pw' #修改短链接域名
我在public/index.html里实在没找到呢

Reply
看透一切的贫僧
May 18th, 2024 at 11:56 am

该评论仅登录用户及评论双方可见

Reply
1. Rui
  May 21st, 2024 at 02:03 pm
  
  @看透一切的贫僧
  
  好了，地址更新了一下 clash-converter.imgki.com
  
  Reply
躲闪的贫僧
May 3rd, 2024 at 03:56 pm

请问如何增加多个后端向您这样。
https://pic1.58cdn.com.cn/nowater/webim/big/n_v20bd21ce312fa4a58ba3142e519d09a05.png

Reply
1. 躲闪的贫僧
  May 3rd, 2024 at 04:05 pm
  
  @躲闪的贫僧
  
  会了打扰了
  
  Reply
laoya
October 18th, 2023 at 11:05 am

谢谢博主你的搭建教程是我找到最好的

Reply
Faramita 1
September 26th, 2023 at 09:22 am

Myurls我安装好之后单独测试是可以转换链接并访问的，但是subweb前端总是获取短链接失败

Reply
1. Rui
  November 27th, 2023 at 07:13 pm
  
  @Faramita
  
  试试修改public/index.html
  
  Reply
  1. Faramita
    November 30th, 2023 at 10:03 am
    
    @Rui
    
    建议subconverter也使用 git clone到本地之后，compose build起容器，因为有些人需要改base/pref里面的managed_config_prefix值
    
    Reply
    
    Rui
    December 5th, 2023 at 04:33 pm
    
    @Faramita
    
    昂这个是对的我偷懒了
    
    Reply
2. laoya
  October 20th, 2023 at 08:48 pm
  
  @Faramita
  
  该评论仅登录用户及评论双方可见
  
  Reply
  1. laoya
    October 20th, 2023 at 08:50 pm
    
    @laoya
    
    短链接域名后加/short
    
    Reply
bigivan
March 25th, 2023 at 05:41 pm

短连接的可以使用其他自部署的服务么，比如yourls，兄弟用的这个myurls，我部署了几次都没有成功。:(
谢谢

Reply
1. 心空之上
  March 28th, 2024 at 06:24 pm
  
  @bigivan
  
  楼主你看过这个项目吗：https://github.com/nitezs/sub2clash，这个项目是不是部署了就可以实现你文章中的subconverter，subweb和myurl的功能了呢？但是我访问他的示例网站没有解析出来我的链接呀。
  
  Reply
2. Rui
  November 28th, 2023 at 08:21 am
  
  @bigivan
  
  yourls肯定是不行的，最近我看作者更新了一些bug，你可以耐心再试试|´・ω・)ノ
  
  Reply
bigivan
March 25th, 2023 at 05:40 pm

短连接的可以使用其他自部署的服务么，比如yourls，兄弟用的这个myurls，我部署了几次都没有成功。:(
谢谢

Reply
1. 二毛
  May 25th, 2025 at 05:17 pm
  
  @bigivan
  
  弄了两天，没有成功，卡在获取https://proxy.golang.org/github.com/bytedance/sonic/@v/v1.11.3.mod 这个文件上
  
  Reply
2. ku
  January 3rd, 2025 at 04:25 pm
  
  @bigivan
  
  请问这个在哪里改或者添加呢
  const backend = 'https://s.2z.pw' #修改短链接域名
  我在public/index.html里实在没找到呢
  
  Reply
3. filefox
  January 2nd, 2025 at 09:33 am
  
  @bigivan
  
  用AI写了个使用文件存储的短链接转换，小机器跑myurl起不来，一直OOM，用文件存储就好了。
  https://github.com/filefox/tiny_url
  
  Reply
4. EMO
  November 17th, 2024 at 01:00 am
  
  @bigivan
  
  这个我试了，还是无法获取到短链接。况且这个/short是哪里来的参数
  
  Reply
5. EMO
  November 17th, 2024 at 12:57 am
  
  @bigivan
  
  我和上面有些人都问题一样。可以获取长链接，也可以单独将长链接拿出来转为短链接。但是就是不能在页面中直接获取短链接。
  
  Reply
6. Vanhelsin
  September 29th, 2024 at 07:43 pm
  
  @bigivan
  
  大佬问个小白问题，反代的话是否需要自己去申请域名来用来指向前端或后端，正在学习如何自行搭建前后端
  
  Reply
7. 懵懂小白
  May 17th, 2024 at 02:20 pm
  
  @bigivan
  
  想问下，如何得到链接后导入clash，是能显示总流量，使用流量和到期时间这些的？
  
  Reply
  1. Rui
    May 21st, 2024 at 02:03 pm
    
    @懵懂小白
    
    有些机场自己搞的吧我也不是很清楚~
    
    Reply
8. swift
  April 26th, 2024 at 12:51 pm
  
  @bigivan
  
  增加远端服务配置这步一直没法成功，搞了十几次了。能指导一下不。感谢！
  
  Reply
9. xxx
  June 20th, 2023 at 04:45 pm
  
  @bigivan
  
  该评论仅登录用户及评论双方可见
  
  Reply
10. xxx
  June 20th, 2023 at 04:43 pm
  
  @bigivan
  
  该评论仅登录用户及评论双方可见
  
  Reply
骄傲的大黄
January 31st, 2023 at 09:43 am

大神，我用的是宝塔面板，Nginx1.20，MyUrls 跨站一直有问题，Nginx照着配置的，是版本问题吗？

Reply
1. Rui
  January 31st, 2023 at 04:24 pm
  
  @骄傲的大黄
  
  宝塔我没看过，你可以搜搜宝塔跨站的教程。myurls这个跨站就是非常有问题。另外就是myurl中vi public/index.html这个地方有个地址需要改，一定记得改了。
  
  Reply
  1. 骄傲的大黄
    February 3rd, 2023 at 11:00 pm
    
    @Rui
    
    [filter_remote]
    http://127.0.0.1:25500应该是对应的subconvertor域名，测试了您服务，也是一样的问题。不知道是不是bug。
    
    Reply
    
    Rui
    February 4th, 2023 at 04:23 pm
    
    @骄傲的大黄
    
    http://127.0.0.1:25500 如果是用这个表明你再本地运行subconvertor 你需要在本地安装subconvertor
    
    Reply
  2. 骄傲的大黄
    February 3rd, 2023 at 10:59 pm
    
    @Rui
    
    不知为何还是不行，另外就是如果终端选QX，分流规则地址就会错误，[filter_remote]
    http://127.0.0.1:25500/getruleset?type=2&url=aHR0cHM6Ly9yYXcuZ2l0aHVidXNlcmNvbnRlbnQuY29tL0FDTDRTU1IvQUNMNFNTUi9tYXN0ZXIvQ2xhc2gvTG9jYWxBcmVhTmV0d29yay5saXN0&group=8J-OryDlhajnkIPnm7Tov54, tag=???? 全球直连, enabled=true
    
    Reply
    
    Janyd
    February 26th, 2023 at 09:14 pm
    
    @骄傲的大黄
    
    后端的/base/pref.toml文件也要把127.0.0.1改成后端域名
    
    Reply
    
    Rui
    February 4th, 2023 at 04:23 pm
    
    @骄傲的大黄
    
    QX没用过你可以搜搜其他大佬的服务看是否正常
    
    Reply
    
    Janyd
    February 26th, 2023 at 09:20 pm
    
    @Rui
    
    大佬能把前后端都重新打包成新的docker么？前端可以支持挂载.env和Subconverter.vue文件，后端可以支持挂载/base/pref.toml文件
    
    Reply
    
    Rui
    February 28th, 2023 at 04:08 pm
    
    @Janyd
    
    这是个好主意。
    
    Reply
    
    心空之上
    March 28th, 2024 at 07:52 pm
    
    @Rui
    
    楼主你看过这个项目吗：https://github.com/nitezs/sub2clash，这个项目是不是部署了就可以实现你文章中的subconverter，subweb和myurl的功能了呢？但是我访问他的示例网站没有解析出来我的链接呀。
    
    Reply

自建Clash订阅转换 - Subconverter+Subweb+MyUrls搭建教程 - 全docker完成 - mihomo内核避坑指南

Rui • 2024 年 03 月 24 日

<div class="tip share">请注意，本文编写于 799 天前，最后修改于 2 天前，其中某些信息可能已经过时。</div>

---

~~春节期间，有点时间，写个教程......~~

调整了工作岗位后，有点时间可以再调整一下

> 由于这套东西的作者写的吧有点迷惑，有些地方存在很多坑，比较晦涩，而且作者已经长久不更新，有些地方真的有坑。各位准备入坑的请做好准备。

爱墨迹已经搭建好的服务长期免费使用[https://clash-converter.imgki.com](https://clash-converter.imgki.com/)/
</div>

# Clash订阅转换

把Vmess/ss等放入这里面，之后可以生成带有分流规则的Clash连接，甚至是一键导入的Clash。

![image.png](https://imgki.com/usr/uploads/2023/11/3945231308.png)

**部署整体逻辑**

我一直是习惯Docker的方式，所以以下尽量是用docker/docker-compose，下面先分别对每个组件进行安装，这里尽量采用官方image。

```plaintext
sub.imgki.com                  -> sub-web
subconverter.imgki.com         -> subconverter
subconverter-mate.imgki.com    -> subconverter-mate
s.imgki.com                    -> MyUrls
```

目录结构

```bash
~/clash
├── docker-compose.yml
├── MyUrls
├── redis
├── subconverter
└── sub-web
```

# 搭建后端Subconverter

## docker部署

项目地址：[https://github.com/tindy2013/subconverter](https://github.com/tindy2013/subconverter)

Docker官方指引：[https://github.com/tindy2013/subconverter/blob/master/README-docker.md](https://github.com/tindy2013/subconverter/blob/master/README-docker.md)

</div>

```bash
#docker部署
docker run -d --name subcon --restart=always -p 25500:25500 tindy2013/subconverter:latest
```

```bash
#docker-compose部署
subconverter:
    image: tindy2013/subconverter:latest
    container_name: subconverter
    restart: always
    ports:
      - 25500:25500
```

这里先不涉及自己编译的问题，从官方直接拉去image，注意请使用latest。

因为前期出现过一些bug，到时会泄露节点的问题，0.81之后应该就没啥大问题了。关于编译问题此处不再讨论。

### [MetaCubeX](https://github.com/MetaCubeX)后端

```yaml
subconverter-mate:
    image: ghcr.io/metacubex/subconverter:latest
    container_name: subconverter-metacubex
    restart: always
    ports:
      - 25501:25500
```

```bash
#docker部署
docker run -d --name subconverter-metacubex --restart=always -p 25501:25500 ghcr.io/metacubex/subconverter:latest
```

## 反代服务

一般大家用的宝塔或者NMP按照正常处理反代即可。如果是用Ningx Manager Proxy添加好域名 `subapi.imgki.com`

![image.png](https://imgki.com/usr/uploads/2023/11/2425686377.png)

注意：docker的ip处理
</div>

也可以参考最后docker-compose的网络配置方案，两个网络，一个用于内部通信，另外一个用于和NPM通信
</div>

```bash
#把NMP加入到bridge网络中
docker network connect bridge nginx-proxy-app-1
```

![image.png](https://imgki.com/usr/uploads/2023/11/1044241228.png)

之后用 `docker inspect subcon`查看容器的ip是 `172.17.0.5`.

![image.png](https://imgki.com/usr/uploads/2023/11/1895898622.png)

之后直接访问显示File not found.就是ok了

> 2023年，不良林爆出了Subconverter安全隐患，建议尽快升级到0.81 e7380d8

# 搭建前端Subweb

项目地址：[https://github.com/CareyWang/sub-web](https://github.com/CareyWang/sub-web)
</div>

## 配置前端

如果用docker搭建，需要配置前端之后，重新build镜像。

```bash
# Clone项目到本地
git clone https://github.com/CareyWang/sub-web.git
cd sub-web

# 编辑.env配置文件
vi .env

# 修改后端地址、短链接地址
# API 后端
VUE_APP_SUBCONVERTER_DEFAULT_BACKEND = "https://subapi.imgki.com"

# 短链接后端
VUE_APP_MYURLS_API = "https://s.imgki.com/short"

# 编辑.
cd src/views
vi Subconverter.vue

#这里我直接硬编辑源文件了，原则上不建议
placeholder="爱墨迹免费提供 |  https://subapi.imgki.com/sub?"

backendOptions: [{ value: "https://subapi.imgki.com/sub?" }],
```

## 增加远端服务配置

编辑 `nano sub-web/src/config/remote-configs.js`

![mstsc_NNHhxDHsCb.png](https://imgki.com/usr/uploads/2023/11/2068273642.png)

当然，还有其他大佬的分流规则库。

**ACL4SSR的库** :[https://github.com/ACL4SSR/ACL4SSR/tree/master/Clash](https://github.com/ACL4SSR/ACL4SSR/tree/master/Clash)

~~**blackmatrix7的库** :[https://github.com/blackmatrix7/ios_rule_script/tree/master/rule/Clash](https://github.com/blackmatrix7/ios_rule_script/tree/master/rule/Clash)~~

~~**神机规则库** :[https://github.com/DivineEngine/Profiles/tree/master/Clash/RuleSet](https://github.com/DivineEngine/Profiles/tree/master/Clash/RuleSet)~~

这里还可以自己做分流规则加入进去，但是本文不涉及了。

## 构建镜像&部署服

```bash
#构建镜像
docker build -t subweb-local:latest .

#部署服务
docker run -d -p 58080:80 --restart always --name subweb subweb-local:latest
```

# 搭建短域名Myurls

项目地址：[https://github.com/CareyWang/MyUrls](https://github.com/CareyWang/MyUrls)
</div>

官方发布了docker，可以直接使用，其中作者也给出了Dockerfile，你也可以自己打包镜像。这里曾经碰到很多坑，后来其实也都修复了。

## ~~作废方案~~

这个是20230121首次发布时使用的方案，比较复杂，这两天看了一下作者应该是修复了docker以及docker compose，而且期间也经历了多次修改调整。

最终搞来搞去，总算是搞定了，按照下面的教程走。

1. 部署服务

```bash
#部署Redis，因为需要redis。如果是docker-compose会自己部署redis，我是直接apt update安装了。
apt update
apt install redis-server -y 
之后redis-cli测试一下

#clone项目到本地
git clone https://github.com/CareyWang/MyUrls.git MyUrls
cd MyUrls
vi public/index.html
const backend = 'https://i.2z.pw' #修改短链接域名

#部署服务
docker run -d --restart always --net=host --name myurls  -v /root/MyUrls/public:/app/public careywong/myurls:latest -domain i.2z.pw -port 8002 -conn 127.0.0.1:6379  -ttl 180

其中域名、端口按照实际修改，--net=host是为了连接宿主机redis
最关键的-v /root/MyUrls/public:/app/public把修改了index.html的目录映射到容器
```

![image.png](https://imgki.com/usr/uploads/2023/11/1427243911.png)

## 推荐方案

```bash
#clone项目到本地
git clone https://github.com/CareyWang/MyUrls.git MyUrls
cd MyUrls
vi public/index.html
const backend = 'https://s.2z.pw' #修改短链接域名

cd MyUrls
cp .env.example .env #编辑好域名、端口等配置

docker-compose up -d  #直接启动
```

### 设置反代

看你的情况，是lnmp还是NMP，或者很多教程的caddy，总之设置反代。

### 跨域设置

需要设置跨域 `Access-Control-Allow-Origin *`

```bash
#nginx配置
server {
    server_name example.com;

location / {
        add_header 'Access-Control-Allow-Origin' '*';
        proxy_pass http://127.0.0.1:8002/;
    }
}
```

我是用的自己的cdn反代，直接开启自适应即可

![chrome_SgUam46NTY.png](https://imgki.com/usr/uploads/2023/11/1407992119.png)

### get方式Url长度问题

因为get的url长度非常长，需要调整get请求长度限制。

```bash
#nginx设置
client_max_body_size 24M;
client_body_buffer_size 128k;

client_header_buffer_size 5120k;
large_client_header_buffers 16 5120k;
```

# 套装部署

近期重新梳理了一下几个套装，可以docker compose 一键启动

## 拉取相关项目

```bash
mkdir clash && cd clash

git clone https://github.com/CareyWang/sub-web.git 
cd sub-web
# 按照上述教程完成sub-web配置,.env view等文件

cd .. 
git clone https://github.com/CareyWang/MyUrls.git MyUrls
cd MyUrls
#按照上述教程完成 Myurls配置

cd..
nano docker-compose.yml
#按照以下文档编辑docker-compose.yml
```

## 配置docker-compose.yml

稍微解释一下关于 `docker-compose.yml`

注：以下仅供参考，真的不能生搬硬套，给大家一个思路。
</div>

```bash
#20260530修改
services:
  subconverter:
    image: tindy2013/subconverter:latest
    container_name: clash-subconverter
    restart: unless-stopped

ports:
      - "127.0.0.1:25500:25500"

mem_limit: 256m
    memswap_limit: 256m
    cpus: "0.5"
    pids_limit: 100

networks:
      - clash-net
      - webser

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

subconverter-mate:
    image: ghcr.io/metacubex/subconverter:latest
    container_name: clash-subconverter-mate
    restart: unless-stopped

ports:
      - "127.0.0.1:25501:25500"

mem_limit: 256m
    memswap_limit: 256m
    cpus: "0.5"
    pids_limit: 100

networks:
      - clash-net
      - webser

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

subweb:
    build:
      context: ./sub-web
    container_name: clash-sub-web
    restart: unless-stopped

env_file:
      - ./sub-web/.env

ports:
      - "127.0.0.1:5080:80"

depends_on:
      - subconverter
      - subconverter-mate
      - myurls

mem_limit: 256m
    memswap_limit: 256m
    cpus: "0.5"
    pids_limit: 100

networks:
      - clash-net
      - webser

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

myurls:
    build:
      context: ./MyUrls
    container_name: clash-myurls
    restart: unless-stopped

ports:
      - "5081:8080"

volumes:
      - ./MyUrls/logs:/app/logs

depends_on:
      myurls-redis:
        condition: service_healthy

entrypoint:
      - /app/myurls
      - -domain
      - s.imgki.com
      - -conn
      - myurls-redis:6379
      - -proto
      - https
      - -port
      - "8080"

mem_limit: 256m
    memswap_limit: 256m
    cpus: "0.5"
    pids_limit: 100

networks:
      - clash-net
      - webser

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

myurls-redis:
    image: redis:7-alpine
    container_name: clash-myurls-redis
    restart: unless-stopped

command:
      - redis-server
      - --appendonly
      - "yes"
      - --appendfsync
      - everysec
      - --maxmemory
      - 128mb
      - --maxmemory-policy
      - allkeys-lru

volumes:
      - ./redis/data:/data

expose:
      - "6379"

mem_limit: 192m
    memswap_limit: 192m
    cpus: "0.3"
    pids_limit: 80

healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 10s

networks:
      - clash-net

logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

networks:
  clash-net:
    driver: bridge

webser:
    external: true
```

## subconverter

这是原版订阅转换服务。

使用镜像 tindy2013/subconverter:latest。

本机访问端口是 25500。

它绑定在 127.0.0.1 上，所以外网不能直接访问，只能本机或反向代理访问。

## subconverter-mate

这是 MetaCubeX 版本的订阅转换服务。

使用镜像 ghcr.io/metacubex/subconverter:latest。

本机访问端口是 25501。

容器内部仍然使用 25500 端口，只是映射到宿主机的 25501。

这个版本通常更适合 Clash Meta / Mihomo。

## subweb

这是订阅转换的网页前端。

它从本地的 ./sub-web 目录构建镜像。

本机访问端口是 5080。

它依赖 subconverter、subconverter-mate 和 myurls。

也就是说，前端页面会配合这些后端服务使用。

## myurls

这是短链接服务。

它从本地的 ./MyUrls 目录构建镜像。

它会连接 Redis，并使用 s.imgki.com 作为短链接域名。

生成的链接协议是 https。

需要注意的是，当前 myurls 的 5081 端口是直接暴露到公网的。

如果不想让公网直接访问，建议绑定到 127.0.0.1，或者只通过反向代理访问。

## myurls-redis

这是 Redis 数据库，给 myurls 存储短链接数据。

它只在 Docker 内部网络中使用，没有暴露到公网。

Redis 开启了 AOF 持久化，数据会保存到 ./redis/data。

Redis 设置了最大内存 128MB，超过后会使用 LRU 策略删除旧数据。

如果短链接数据很重要，这个策略可能会导致旧链接失效。

## 网络说明

配置里有两个网络。

clash-net 是内部网络，用于这些服务之间互相通信。

webser 是外部网络，通常给 Nginx、Caddy、Traefik 这类反向代理使用。

webser 必须提前创建，否则启动会失败。

## 端口说明

subconverter 本机端口是 25500。

subconverter-mate 本机端口是 25501。

subweb 本机端口是 5080。

myurls 端口是 5081，并且当前可能公网可访问。

Redis 不对外暴露。

## 资源限制

大部分服务限制为 256MB 内存、0.5 个 CPU、100 个进程。

Redis 限制为 192MB 内存、0.3 个 CPU、80 个进程。

这样可以防止容器占用过多服务器资源。

## 日志限制

每个容器的 Docker 日志最多保留 3 个文件，每个文件最大 10MB。

这样可以避免日志无限增长占满磁盘。

## 启动顺序

Redis 先启动。

Redis 健康后，myurls 启动。

然后 subweb 会在 subconverter、subconverter-mate、myurls 启动后再启动。

不过 subweb 的依赖只保证启动顺序，不保证后端服务已经完全可用。

## 主要注意点

myurls 当前端口可能暴露公网，需要确认是否符合预期。

Redis 的 allkeys-lru 策略可能会删除旧短链接。

webser 网络需要提前创建。

使用 latest 镜像可能会因为自动更新导致行为变化，生产环境建议固定版本。

整体来说，这份配置适合搭建一个带短链接功能的订阅转换服务，并通过反向代理对外提供访问。

自建Clash订阅转换 - Subconverter+Subweb+MyUrls搭建教程 - 全docker完成 - mihomo内核避坑指南

40 comments

Leave a Comment Cancel reply
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

编译Lean的Openwrt固件全攻略

搭建Tailscale中继节点|白嫖DERP中继节点|低调分享

Dell 9020m + 魔改i7 4780hq黑苹果折腾记录

自建Clash订阅转换 - Subconverter+Subweb+MyUrls搭建教程 - 全docker完成 - mihomo内核避坑指南

FastCopy 基本教程和常见问题

【教程】Docker常用命令大全汇总

利用install-php-extensions构建自己的php-docker镜像

常用一键命令备份

Moeclub锐速脚本更新

超强Linux测试脚本 - LemonBench

自建Clash订阅转换 - Subconverter+Subweb+MyUrls搭建教程 - 全docker完成 - mihomo内核避坑指南

40 comments

Leave a Comment Cancel reply 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

自建Clash订阅转换 - Subconverter+Subweb+MyUrls搭建教程 - 全docker完成 - mihomo内核 避坑指南

Leave a Comment Cancel reply
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

自建Clash订阅转换 - Subconverter+Subweb+MyUrls搭建教程 - 全docker完成 - mihomo内核避坑指南