baiqi-cf-worker-mihomo - GitLite

KO | EN

gitlite — search

#animation #self-hosted #kubernetes #typescript #markdown #android #large-language-models #docker #vue #nextjs

baiqi-cf-worker-mihomo

(★ 74)

Cloudflare Worker VLESS subscription script with built-in Mihomo provider and preferred IP sources.

파일 탐색기

ZIP 다운로드

.gitignore
ADD.example.txt
calc-token.js
config.example.json
LICENSE
README.md
worker.js
wrangler.toml.example

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`node`

설명 보기 ▼

서버 측 JavaScript 플랫폼 (Node.js).
더 많은 정보: <https://nodejs.org/docs/latest/api/cli.html#options>.

node {{path/to/file}}

JavaScript 파일 실행:

node

REPL(대화형 셸) 시작:

node --watch {{path/to/file}}

지정된 파일을 실행하고 가져온 파일이 변경될 때 프로세스를 재시작 (Node.js 버전 18.11+ 필요):

🔍

`npx`

설명 보기 ▼

이 명령은 `npm exec`의 별칭입니다.

tldr npm exec

자세한 내용은 원본 명령을 참고하세요:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Cloudflare Worker VLESS/WS/TLS subscription script with a built-in Mihomo provider endpoint.

This package is a cleaned publishing copy. It contains no Cloudflare account ID, token, KV namespace ID, custom domain, UUID, or private credential.

## Files

- `worker.js` - Worker script.
- `calc-token.js` - Local helper for calculating subscription tokens.
- `wrangler.toml.example` - Wrangler deploy template.
- `config.example.json` - Optional KV `config.json` example.
- `ADD.example.txt` - Optional KV `ADD.txt` preferred-IP source example.
- `LICENSE` - Upstream Apache-2.0 license.

## Required Cloudflare bindings

Create one KV namespace and bind it as `KV`.

Set these Worker variables:

| Name | Required | Example | Notes |
|---|---:|---|---|
| `UUID` | yes | `00000000-0000-4000-8000-000000000000` | VLESS UUID. Generate your own. |
| `ADMIN` or `KEY` | yes | `change-me-admin-password` | Admin password and fallback secret. |
| `NEW_IP` | no | `true` | Keeps the Worker using the newer IP behavior used by this package. |

Do not commit real UUIDs, admin passwords, API tokens, account IDs, or namespace IDs.

## Deploy

1. Copy the template:

```powershell
Copy-Item wrangler.toml.example wrangler.toml
```

2. Edit `wrangler.toml`:

```toml
name = "your-worker-name"
kv_namespaces = [
  { binding = "KV", id = "your-kv-namespace-id" }
]

[vars]
UUID = "your-vless-uuid"
ADMIN = "your-admin-password"
KEY = "your-admin-password"
NEW_IP = "true"
```

3. Deploy:

```powershell
npx wrangler deploy
```

Recommended GitHub repository contents:

```text
worker.js
calc-token.js
README.md
LICENSE
wrangler.toml.example
config.example.json
ADD.example.txt
.gitignore
```

## Usage

The subscription token is:

```text
MD5MD5(<worker-host> + <UUID>)
```

Calculate it locally:

```powershell
node calc-token.js your-worker-name.your-subdomain.workers.dev your-vless-uuid
```

For the default Worker domain, `<worker-host>` is like:

```text
your-worker-name.your-subdomain.workers.dev
```

For a custom domain, use the custom host, for example:

```text
sub.example.com
```

Endpoints:

```text
https://<worker-host>/mihomo?token=<subscription-token>&count=100
https://<worker-host>/sub?token=<subscription-token>
```

Debug endpoint:

```text
https://<worker-host>/mihomo?token=<subscription-token>&count=1024&debug=1&refresh=1
```

Expected debug fields:

- `total` - returned node count.
- `preferred` - nodes from preferred sources.
- `random` - Cloudflare CIDR random-fill nodes.
- `categories` / `remarks` - source breakdown.

## Preferred IP sources

`/mihomo` uses built-in public preferred-IP sources first. If there are not enough nodes, it fills with `CF-CIDR-random`.

Optional KV key:

```text
ADD.txt
```

`ADD.txt` can contain direct IPs or HTTP raw text/CSV URLs. URL sources are parsed and capped per source so one large list does not dominate the output.

Example content is in `ADD.example.txt`.

After changing `ADD.txt`, use:

```text
/mihomo?token=<subscription-token>&count=1024&debug=1&refresh=1
```

## Optional KV config

The Worker can run from environment variables alone. If you want persistent config, put `config.example.json` into KV as:

```text
config.json
```

At minimum, set your own `UUID` and `HOST` / `HOSTS`.

## Attribution

This publishing copy is maintained as `baiqi-cf-worker-mihomo`, based on CFspider Worker code, and keeps the upstream Apache-2.0 license. Keep `LICENSE` and preserve attribution when publishing your GitHub repository.

## Safety

Use only on infrastructure you own or are allowed to operate. Follow Cloudflare terms and local law.