- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add gosuda/portal-tunnel --skill portal-relay-hetzner -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add gosuda/portal-tunnel --skill portal-relay-hetzner -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add gosuda/portal-tunnel --skill portal-relay-hetzner -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add gosuda/portal-tunnel --skill portal-relay-hetzner -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-relay/skills/portal-relay-hetzner来自发布者
This skill creates and opens the host. portal-relay deploys the relay on it. Follow ../portal-relay/references/provider-contract.md (the portal-relay skill's contract in this same plugin; the path is relative to this file, so it matches the installed version and needs no network) for the phase order, credential rules, and approval rules. This file adds only what is specific to Hetzner Cloud.
hcloud version. If the CLI is missing, point to the official hcloud install instructions and stop.hcloud context active names the active project context, and a read-only call such as hcloud server-type list -o noheader proves the token works here. Do not open ~/.config/hcloud/cli.toml; it stores the token.When no context works, ask the user to create a project API token in the Hetzner Console and run hcloud context create <name> locally; the CLI prompts for the token, so it never appears in chat or in shell history. A project token can change every resource in that project, so suggest a dedicated project for the relay. In a CI or sandbox environment that the user controls, HCLOUD_TOKEN in its secret store also works; never set it in a command line.
Collect and show, then wait for approval:
hcloud location list) and server type (hcloud server-type list; read current names and prices from hcloud server-type describe <type> instead of assuming them). The smallest Arm or x86 type is enough; the relay image supports linux/arm64 and linux/amd64.hcloud image list --type system.hcloud ssh-key list, or the user's public key added with hcloud ssh-key create --public-key-from-file. Without one Hetzner emails a root password; avoid that.hcloud primary-ip create --type ipv4 --name <name> --location <location>, with auto-delete off) and pass it with --primary-ipv4, so the glue address survives server re-creation.--enable-protection delete,rebuild against accidental deletion.hcloud firewall create --name <name> --rules-file rules.json, where each rule is {"direction": "in", "protocol": "tcp" | "udp", "port": "443" | "40000-40009", "source_ips": ["0.0.0.0/0", "::/0"]} (restrict SSH to the operator's address when known).hcloud server create --name <name> --type <type> --image <image> --location <location> --ssh-key <key> --firewall <firewall> --primary-ipv4 <ip>.hcloud server ip <name>.Ubuntu images on Hetzner Cloud have no extra host firewall by default; if the user enabled ufw, open the same ports there.
ssh root@<ip> works, and after deployment dig @<ip> <relay domain> NS and curl -fsS https://<relay domain>/api/healthz succeed. A port that times out is usually missing from the Cloud Firewall.Then continue with the portal-relay skill from Verify the host, not from Deploy: a fresh image may lack Docker and Compose v2, and that step checks and, with approval, installs them. Use this host's public address as the glue address. The NS and glue records come before Deploy, at the common skill's Delegate DNS step, because the relay's first start needs them to issue its certificate; the DS comes after Deploy, at Publish the DS. Report the server, firewall, and primary IP with their hourly or monthly price, and rollback: hcloud server delete <name>, hcloud firewall delete <name>, and hcloud primary-ip delete <name> (disable protection first if it was enabled).
Portal can also use Hetzner DNS as its ACME DNS provider (ACME_DNS_PROVIDER=hetzner); that is a relay setting covered by the configuration reference, not by this skill, and Hetzner DNS does not support ENS DNSSEC automation.
Create a Hetzner Cloud server for a Portal relay with the hcloud CLI, attach a Hetzner Cloud Firewall that opens only the relay ports, keep a stable primary IPv4, and hand the host to portal-relay for
---name: portal-relay-hetznerdescription: Create a Hetzner Cloud server for a Portal relay with the hcloud CLI, attach a Hetzner Cloud Firewall that…---# plugins/portal-relay/skills/portal-relay-hetzner/SKILL.md概览
Create a Hetzner Cloud server for a Portal relay with the hcloud CLI, attach a Hetzner Cloud Firewall that opens only the relay ports, keep a stable primary IPv4, and hand the host to portal-relay for deployment. Use when the user wants to run a Portal relay on Hetzner Cloud. Do not use for a server that already exists (portal-relay), for DNS changes at Cloudflare (portal-relay-cloudflare), or for Hetzner Robot dedicated servers.
常见问题
从发布者处下载 plugins/portal-relay/skills/portal-relay-hetzner/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/gosuda/portal-tunnel。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。