modal-nz

KO | EN

gitlite — search

#python #ai #typescript #android #rust #deep-learning #linux #docker #macos #java #windows #awesome-list #mcp #open-source

(★ 16)

Modal 容器扎针

modal-nz Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Modal 哪吒探针部署 🚀

> ⭐ 觉得有用？点个 **Star** 支持一下！⭐

> 注册地址：https://modal.com

基于 **GitHub Actions** 一键部署 **Modal 哪吒探针**，支持 **V0 / V1**，支持 **全球 80+ 区域** 自由选择。

---

## 📋 目录

- [快速开始](#-快速开始)
- [Secrets 配置](#-secrets-配置)
- [工作流快捷输入](#-工作流快捷输入)
- [部署区域](#-部署区域)
- [API 调用](#-api-调用)
- [注意事项](#-注意事项)

---

## 🚀 快速开始

```
1. Fork 本仓库
2. 在仓库 Settings → Secrets and variables → Actions 中配置必填 Secrets
3. 进入 Actions → Modal 容器扎针 → Run workflow
4. 选择部署区域，点击运行
5. 等待部署完成，在哪吒面板查看节点上线
```

---

## 🔐 Secrets 配置

在仓库 **Settings → Secrets and variables → Actions** 中设置：

### 必填项

### 按版本必填

| Secret 名称 | 适用版本 | 说明 |
| :--- | :---: | :--- |
| `UUID` | **V1 必填** | 不同平台运行需修改 UUID，否则节点会被覆盖 |
| `NEZHA_PORT` | **V0 必填** | 哪吒监控端口，留空则自动判断 |

### 可选项

| Secret 名称 | 默认值 | 说明 |
| :--- | :---: | :--- |
| `AUTO_ACCESS` | `true` | 是否添加自动访问保活任务 |
| `KEEPALIVE_INTERVAL` | `120` | 自访问保活请求间隔（秒） |

> 💡 **提示**：`PROJECT_URL` 无需配置，应用会在首次请求时自动检测。

---

## ⚡ 工作流快捷输入

运行工作流时，可直接在界面填写以下参数，**无需修改 Secrets 即可临时覆盖**：

```
优先级：工作流输入（非空） > Repository Secret
```

> 🎯 **典型场景**：多账号切换、临时测试不同区域、不想频繁修改 Secrets。

---

## 🌍 部署区域

支持全球 **80+ 区域**，涵盖 AWS / GCP / OCI / Azure 四大云平台。

> 📋 **API 调用时直接复制「选择值」列的内容作为 `deploy_region` 的值。**

</details>

<details>
<summary>🇺🇸 美国中部 US-CENTRAL（8 个区域）</summary>

</details>

<details>
<summary>🇺🇸 美国南部 US-SOUTH（2 个区域）</summary>

</details>

</details>

</details>

<details>
<summary>🇪🇺 欧洲北部 EU-NORTH（5 个区域）</summary>

</details>

<details>
<summary>🇪🇺 欧洲南部 EU-SOUTH（5 个区域）</summary>

</details>

<details>
<summary>🇨🇳 亚太东北 AP-NORTHEAST（10 个区域）</summary>

</details>

<details>
<summary>🇸🇬 亚太东南 AP-SOUTHEAST（5 个区域）</summary>

</details>

<details>
<summary>🇮🇳 亚太南部 AP-SOUTH（7 个区域）</summary>

</details>

</details>

</details>

</details>

</details>

---

## 📡 API 调用

通过 GitHub API 触发工作流，适合自动化和多账号批量部署。

### 基础格式

```bash
curl -X POST \
  https://api.github.com/repos/{owner}/{repo}/actions/workflows/Modal.yml/dispatches \
  -H "Accept: application/vnd.github.v3+json" \
  -H "Authorization: token {your_github_token}" \
  -d '{
    "ref": "main",
    "inputs": {
      "deploy_region": "us-east | 美国东部（自动分配）",
      "modal_token_id": "",
      "modal_token_secret": "",
      "nezha_server": "",
      "nezha_key": "",
      "uuid": "",
      "nezha_port": ""
    }
  }'
```

### 调用示例

<details>
<summary>1️⃣ 最简调用 — 全部使用 Secret，默认区域</summary>

> 所有变量回退到 Secret，区域默认 `us-east`

</details>

<details>
<summary>2️⃣ 只改部署区域 — 其余用 Secret</summary>

</details>

<details>
<summary>3️⃣ 工作流输入覆盖全部变量</summary>

```bash
curl -X POST \
  https://api.github.com/repos/oyz8/modal-nz/actions/workflows/Modal.yml/dispatches \
  -H "Accept: application/vnd.github.v3+json" \
  -H "Authorization: token ghp_UBXXXXXXXXXf" \
  -d '{
    "ref": "main",
    "inputs": {
      "deploy_region": "asia-northeast1 | GCP 东京",
      "modal_token_id": "ak-xxxxxxxxxxxxxxxx",
      "modal_token_secret": "as-xxxxxxxxxxxxxxxx",
      "nezha_server": "nezha.example.com:8008",
      "nezha_key": "your-nezha-client-secret-here",
      "uuid": "a1b2c3d4-5678-9012-abcd-ef1234567890",
      "nezha_port": "5555"
    }
  }'
```

</details>

<details>
<summary>4️⃣ 只覆盖哪吒相关 — Modal 令牌用 Secret</summary>

```bash
curl -X POST \
  https://api.github.com/repos/oyz8/modal-nz/actions/workflows/Modal.yml/dispatches \
  -H "Accept: application/vnd.github.v3+json" \
  -H "Authorization: token ghp_UBXXXXXXXXXf" \
  -d '{
    "ref": "main",
    "inputs": {
      "deploy_region": "eu-west | 欧洲西部（自动分配）",
      "nezha_server": "nz.mysite.com:8008",
      "nezha_key": "my-nezha-v1-secret",
      "uuid": "11111111-2222-3333-4444-555555555555"
    }
  }'
```

> `modal_token_id`、`modal_token_secret`、`nezha_port` 未传 → 自动回退 Secret

</details>

<details>
<summary>5️⃣ 哪吒 V0 模式 — 需要指定端口</summary>

```bash
curl -X POST \
  https://api.github.com/repos/oyz8/modal-nz/actions/workflows/Modal.yml/dispatches \
  -H "Accept: application/vnd.github.v3+json" \
  -H "Authorization: token ghp_UBXXXXXXXXXf" \
  -d '{
    "ref": "main",
    "inputs": {
      "deploy_region": "us-west2 | GCP 洛杉矶",
      "nezha_server": "nezha.example.com",
      "nezha_key": "your-v0-agent-key",
      "nezha_port": "5555",
      "uuid": ""
    }
  }'
```

</details>

<details>
<summary>6️⃣ 多账号切换 — 不同 Modal 令牌</summary>

```bash
# 账号 A → 部署到东京
curl -X POST \
  https://api.github.com/repos/oyz8/modal-nz/actions/workflows/Modal.yml/dispatches \
  -H "Accept: application/vnd.github.v3+json" \
  -H "Authorization: token ghp_UBXXXXXXXXXf" \
  -d '{
    "ref": "main",
    "inputs": {
      "deploy_region": "ap-northeast-1 | AWS 东京",
      "modal_token_id": "ak-account-a-token-id",
      "modal_token_secret": "as-account-a-token-secret",
      "nezha_server": "nz.site-a.com:8008",
      "nezha_key": "secret-a",
      "uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
    }
  }'

# 账号 B → 部署到法兰克福
curl -X POST \
  https://api.github.com/repos/oyz8/modal-nz/actions/workflows/Modal.yml/dispatches \
  -H "Accept: application/vnd.github.v3+json" \
  -H "Authorization: token ghp_UBXXXXXXXXXf" \
  -d '{
    "ref": "main",
    "inputs": {
      "deploy_region": "eu-central-1 | AWS 法兰克福",
      "modal_token_id": "ak-account-b-token-id",
      "modal_token_secret": "as-account-b-token-secret",
      "nezha_server": "nz.site-b.com:8008",
      "nezha_key": "secret-b",
      "uuid": "ffffffff-1111-2222-3333-444444444444"
    }
  }'
```

</details>

### 参数速查表

---

## ⚠️ 注意事项

1. **区域值必须完整匹配** choice 选项中的格式：
   ```
   ✅ "ap-northeast-1 | AWS 东京"
   ❌ "ap-northeast-1"
   ❌ "东京"
   ```
2. **敏感信息安全**：通过 API `inputs` 传递的 token/key 可能出现在 Actions 日志中。生产环境建议优先使用 Secret，API 输入仅用于临时覆盖或测试。

3. **空值处理**：`inputs` 中传空字符串 `""` 等同于未传，会自动回退到 Secret。

4. **未传字段**：API 调用中未包含的 `inputs` 字段将使用工作流定义的默认值（空字符串），同样回退到 Secret。

modal-nz

modal-nz Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

modal-nz

modal-nz Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README