relay-server-config

Revisar · 64
Indexado en Registry

Full environment-variable / flag reference for configuring the portal-tunnel relay-server (cmd/relay-server), plus how config is embedded and how Docker/Compose deploys it. Use when configuring, deploying, or debugging a relay.

Verified installs0
Estrellas263
Versión1.0.0
Calidad71/100 · Sólido
Confianza64/100 · Solo sandbox
Auditoría78/100 · Requiere revisión

Perfil del activo

Agents de programación y desarrollo

Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.

Ver categoría

Escenario

Agents de programación

I need a coding agent that can understand a repository, edit code, and review pull requests.

Afinidad con Agent

Claude Code + CLI + Codex

Funciona con Codex, Claude Code, Cursor, CLI o Agents personalizados.

Instalar

Listo

npx skills add gosuda/portal-tunnel --skill relay-server-config

Mantenimiento

Actual

Actualizado hoy

Riesgo

Requiere revisión

Dependency or permission surface needs review

Calidad de GitHub

263

71/100 Calidad · 72/100 Confianza

Etiquetas de cobertura

CodingAgents de programaciónAgents de programaciónagent-skill

Notas de revisión

Dependency or permission surface needs review · Permission surface may require sandboxing

Tarjeta de adopción del Agent

Confianza, auditoría y preparación de instalación de un vistazo

Estas puntuaciones combinan metadatos públicos del repositorio, señales de revisión de OpenAgentSkill, actualidad de mantenimiento y preparación de instalación. Sirven para preseleccionar; no sustituyen la revisión humana.

Calidad

Sólido
71

Solid option that is likely worth shortlisting for production workflows.

Confianza

Solo sandbox
64

Candidata útil con señales de confianza incompletas o mixtas. Manténgala en un espacio aislado hasta que el ciclo de resultados demuestre el ajuste.

Auditoría

Requiere revisión
78

Revisión legible por máquina de la preparación de instalación, los metadatos de seguridad, el mantenimiento y el riesgo de adopción.

Trust Score de OpenAgentSkill v5

Revisión humana antes de instalar

Ejecute solo en un sandbox y compare alternativas cercanas antes de usarla en trabajo real.

CodexClaude CodeCursorOpenAgentSkill CLI

Estrellas

263 estrellas de GitHub

Actividad del repositorio

263 estrellas y 29 forks

Mantenimiento

Actualizado hoy

Licencia

MIT

Instalar

npx skills add gosuda/portal-tunnel --skill relay-server-config

Seguridad de instalación

Ruta estándar de paquete o instalación en tiempo de ejecución

Superficie de permisos

secrets or environment access, network or browser access

Resultados del Agent

Aún no hay datos de resultados del Agent

Documentación

Contexto sólido de README/SKILL.md

Resumen de riesgo

Revisar antes de producción

  • No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, network or browser access
  • Stars/forks activity: 263 stars, 29 forks; issue activity unavailable in current metadata

Preparación de instalación

Ruta de instalación disponible

  • La ruta de instalación está disponible
  • La evidencia del repositorio está disponible
  • La licencia está declarada
  • Aún no hay evidencia de resultados Agent-Proven

Metadatos legibles por Agent

Datos de decisión legibles por máquina para este skill.

Usa este bloque o el JSON integrado para decidir si un Agent debe instalar este skill, elegir una alternativa o pedir revisión humana primero.

Abrir JSON

Tareas adecuadas

  • flujos de Agents de programación
  • Equipos de Claude Code
  • builders willing to evaluate younger projects
  • Inspect source files

Agents adecuados

CodexClaude CodeCursorOpenAgentSkill CLICLI

Decisión de instalación

Comando
npx skills add gosuda/portal-tunnel --skill relay-server-config
Política
Revisar
Revisión humana

Confianza y riesgo

Confianza
64/100
Auditoría
78/100
Nivel de riesgo
Requiere revisión

Ciclo de resultados

Endpoint
/api/agent/outcome
ID del evento
resolve
Resultados
5

Comando de instalación

npx skills add gosuda/portal-tunnel --skill relay-server-config

No usar cuando

  • Equipos que necesitan un SLA con soporte del proveedor
  • production agents without a repository review
  • No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.
  • No OpenAgentSkill engagement data yet
  • Indicios de permisos de alto riesgo: Secrets or environment access

Seguridad de Agent v2

54/100 · Evitar instalación automática

ExperimentalRevisar

Sparse or mixed signals. Useful for discovery, but not for autonomous installation.

Test manually in an isolated workspace and compare against safer alternatives.

Resolver con API

Medio

Acceso a red

El skill probablemente consulta páginas remotas, API, repositorios o servicios externos.

Alto

Secrets or environment access

Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.

  • Indicios de permisos de alto riesgo: Secrets or environment access
  • Dependency or permission surface needs review

Destinos de instalación

Instala este skill en tu flujo de Agent

Usa el endpoint público para obtener el comando, la lista de seguridad, prompts y enlaces canónicos.

skill install

OpenAgentSkill CLI

Resolve policy, run the source installer safely, and report a verified install receipt.

$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install gosuda-relay-server-config

Plan de resolución de Agent

Deja que un Agent valide el ajuste antes de instalar.

La API Resolve devuelve la skill elegida, alternativas, política de seguridad, notas de auditoría, destino de instalación y un prompt listo para usar.

Abrir plan de texto

Agent debe revisar

  • Task fit and alternatives from Resolve API.
  • Audit score, trust score, and safety policy warnings.
  • Install target compatibility for Codex, Claude Code, Cursor, or CLI.

Copiar prompt

Task: Use relay-server-config in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20relay-server-config%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/gosuda-relay-server-config/install
Install command: npx skills add gosuda/portal-tunnel --skill relay-server-config
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.

Traspaso de Agent

Da al Agent la ruta de instalación, no otro directorio.

Usa el endpoint público para obtener el comando, la lista de seguridad, prompts y enlaces canónicos.

Abrir API de instalación

Prompt de Agent

Use relay-server-config for this task. Review https://www.openagentskill.com/api/skills/gosuda-relay-server-config/install, then install with: npx skills add gosuda/portal-tunnel --skill relay-server-config

Metadatos del Registry

Perfil legible por Agent para seleccionar skills automáticamente.

La API Registry expone señales de decisión, confianza, auditoría, casos de uso e instalación sin raspar la interfaz.

Abrir Manifest

Afinidad con Agent

70/100

Agents de programación

Plataformas

Claude Code

Informe de auditoría

Requiere revisión · 78/100

Revisión legible por máquina de la preparación de instalación, los metadatos de seguridad, el mantenimiento y el riesgo de adopción.

Ver informe de auditoríaVer informe de evaluación

Panel de decisión de Agent

Fallback candidate for Coding agents

Prototype with this skill first; keep a fallback candidate ready.

70
Preparación
Prototipo
Etapa

Rol en la pila

Candidata de respaldo

Ajuste principal

Agents de programación

Etiqueta de confianza

Prototipar primero

Ruta de instalación

Comando listo

Úsalo cuando

  • flujos de Agents de programación
  • Equipos de Claude Code
  • builders willing to evaluate younger projects

Evidencia

  • recent repository activity
  • install command or GitHub repo available
  • perfil de calidad 71/100

revisar primero

  • No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.
  • No OpenAgentSkill engagement data yet

Ruta de implementación

  1. 1Instálalo en un Agent de sandbox y ejecuta una tarea de Agents de programación de principio a fin.
  2. 2Compare output quality, latency, and failure behavior against at least one alternative.
  3. 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.

Perfil de confianza

Solo sandbox

Candidata útil con señales de confianza incompletas o mixtas. Manténgala en un espacio aislado hasta que el ciclo de resultados demuestre el ajuste.

64
Trust Score de OpenAgentSkill

Adopción en GitHub

Info

263 estrellas de GitHub

Actividad de stars/forks

Revisar

263 estrellas y 29 forks; la actividad de issues no está disponible en los metadatos actuales

Mantenimiento reciente

Aprobado

Actualizado hoy

Claridad de licencia

Aprobado

MIT

Señales positivas

  • Revisión de IA aprobada
  • La ruta de instalación está disponible
  • La evidencia del repositorio está disponible
  • Repositorio mantenido recientemente
  • El comando de instalación no muestra un patrón de alto riesgo evidente
  • El ciclo de resultados está listo, pero necesita la primera ejecución real de Agent

Revisar antes de instalar

  • No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, network or browser access
  • Stars/forks activity: 263 stars, 29 forks; issue activity unavailable in current metadata
  • Dependency/runtime risk: credential or environment access, external package install surface
  • Permission surface: secrets or environment access, network or browser access
  • Aún no hay informes reales de resultados del Agent
  • Se requiere revisión humana antes de una instalación desatendida

Acción recomendada

Ejecute solo en un sandbox y compare alternativas cercanas antes de usarla en trabajo real.

Perfil de calidad

Sólido candidato para flujos de Agent

Solid option that is likely worth shortlisting for production workflows.

71
Estrellas de GitHub
263
Actualidad
Hoy
Listo para instalar
Licencia
MIT
Revisar antes de instalar: No critical issues found. The skill is documentation-only and does not include any executable steps or risky commands.

Ajuste de flujo

Usa esta skill en estos escenarios

Ajuste de flujo

Añadir a un flujo completo

Lista de alternativas

Compara antes de instalar

Similar skills that may fit this task.

Comparar todo

Resumen

--- name: relay-server-config description: Full environment-variable / flag reference for configuring the portal-tunnel relay-server (cmd/relay-server), plus how config is embedded and how Docker/Compose deploys it. Use when configuring, deploying, or debugging a relay. ---

# relay-server configuration

Entrypoint `cmd/relay-server/main.go`, dispatched by `utils.RunCommands` (`""`/`serve` → serve, `help`). Every flag has an env fallback parsed by `utils.{String,Bool,Int}FlagEnv` at flag-init time (`utils/cmd.go`); flags are declared in `main.go ~79-117`. `--help` shows usage/examples only, not flags.

## Core env vars / flags (default) | Env | Default | Purpose | |---|---|---| | `PORTAL_URL` | `https://localhost` | portal base URL (`--portal-url`) | | `PORTAL_FRONTEND_DIR` | empty | custom SPA dir; empty = embedded (`--frontend-dir`) | | `IDENTITY_PATH` | `./.portal-certs` | identity/cert + `policy.json` dir (`--identity-path`) | | `API_PORT` | `4017` | HTTPS API + frontend (`--api-port`) | | `SNI_PORT` | `443` | public SNI ingress (`--sni-port`) — cannot bind unprivileged; override locally | | `WIREGUARD_PORT` | `51820` | (`--wireguard-port`) | | `EMBEDDED_DNS_PORT` | `53` | embedded authoritative DNS (`--embedded-dns-port`) — default provider; needs 53/tcp+udp and `CAP_NET_BIND_SERVICE` in containers | | `ADMIN_TOKEN` | empty | bearer token for admin/policy APIs (`--admin-token`) | | `LANDING_PAGE_ENABLED` | `false` | (`--landing-page-enabled`) | | `DISCOVERY` | `false` | enable gossip; needs `BOOTSTRAPS` (`--discovery`) | | `BOOTSTRAPS` | empty | comma-separated bootstrap relay URLs (`--bootstraps`) | | `TRUST_PROXY_HEADERS` | `false` | trust XFF etc. (`--trust-proxy-headers`) | | `TRUSTED_PROXY_CIDRS` | empty | (`--trusted-proxy-cidrs`) | | `UDP_ENABLED` / `TCP_ENABLED` | `false` | non-HTTP lease transports | | `MIN_PORT` / `MAX_PORT` | `0` / `0` | lease port range; `0` disables | | `PPROF_ENABLED` / `PPROF_ADDR` | `false` / `127.0.0.1:6060` | pprof | | `X402_ENABLED` / `X402_TESTNET` / `X402_PAY_TO` | `false` / `false` / empty | mounts facilitator under `/api/x402` only when enabled |

Embedded DNS is the default `ACME_DNS_PROVIDER` (empty value): `EMBEDDED_DNS_PORT` (default 53). External provider creds remain env-bound: `ACME_DNS_PROVIDER`, `CLOUDFLARE_TOKEN`, GCP (`GCP_PROJECT_ID`+aliases, `GCP_MANAGED_ZONE`+aliases), Hetzner (`HETZNER_API_TOKEN`/`HCLOUD_TOKEN`), AWS Route53 (`AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`/`AWS_SESSION_TOKEN`/`AWS_REGION`→defaults us-east-1 downstream/`AWS_HOSTED_ZONE_ID`/`AWS_DNSSEC_KMS_KEY_ARN`), `VULTR_API_KEY`, `NJALLA_TOKEN`, `ENS_GASLESS_ENABLED` (unsupported with embedded). Never hardcode these — reference as env vars / secrets.

## Reserved API surface (types/paths.go) Root-host trees that must never fall through to the SPA: `types.ReservedRootPrefixes` = `/api`, `/sdk`, `/discovery`, `/v1`. x402 public paths `/x402/prepare`, `/x402/client.js`; relay facilitator `/api/x402/{supported,verify,settle}`. Discovery: `/discovery`, `/discovery/announce` (only when `DISCOVERY=true`).

## Admin/policy API `GET/POST /api/policy` with `Authorization: Bearer $ADMIN_TOKEN`. POST requires the FULL settings object (partial bodies → 400 `invalid_mode`). Persists to `$IDENTITY_PATH/policy.json`.

## Config embedding & Docker - `config.toml` (version/protocol) and `registry.json` (default relays) are embedded via `manifest.go` and parsed in `types/types.go`. - `docker-compose.yml` runs `ghcr.io/gosuda/portal:2`, publishes TCP 443 + TCP/UDP 53 (embedded DNS, `cap_add: NET_BIND_SERVICE`) + UDP WireGuard port, and passes the above env vars. - `Dockerfile`: Node 22 stage builds the frontend into `cmd/relay-server/dist/app`, then `make build-server-bin` compiles the Go relay.

Detalles técnicos

Versión
1.0.0
Licencia
MIT
Última actualización
22 ago 2026
Publicado
22 ago 2026

Resumen de decisión

Candidata de respaldo

70
Listo
Prototipo
Etapa

recent repository activity

Auditoría

Revisión de instalación

Revisión de instalación y adopción

78
Requiere revisión
Seguridad
75/100
Mantenimiento
100/100
Instalar
92/100
Abrir auditoría completaVer informe de evaluación

Evidencia probada por Agent

Evidencia probada por Agent

Informes de resultados tras resolver, revisar, instalar y una ejecución limitada.

0
Probado
Needs first agent runAuto-instalación: revisar primeroÚltimo: Desconocido
Tasa de éxito
Fallo reciente
Resultados
0
Calidad de salida
Fallidos
0
No relevante
0
Instalaciones
0
Bloqueado por riesgo
0
Configuración necesaria
0
Producción
0

Aún no hay datos de resultados de Agent. La primera ejecución puede informar éxito, configuración necesaria, bloqueos de riesgo, fallo o irrelevancia mediante /api/agent/outcome.

Instalar

Añadir al flujo de Agent

Gratis y de código abierto. Revisa el informe antes de instalar en Agents de producción.

Bucle de crecimiento

Kit para compartir

X

Borrador basado en un caso para relay-server-config, listo para publicar manualmente en X.

Nota del curador
A practical pick for the next repo task:

relay-server-config: Full environment-variable / flag reference for configuring the portal-tunnel relay-server (cmd/relay-server), plus how conf...

263 stars

https://www.openagentskill.com/skills/gosuda-relay-server-config?ref=x
Abrir borrador de X
Respuesta opcional con comando de instalación
Listing + install path for relay-server-config:
https://www.openagentskill.com/skills/gosuda-relay-server-config?ref=x

Install: npx skills add gosuda/portal-tunnel --skill relay-server-config

Fuente de la ficha

Indexado por Registry

Reclamable

Esta ficha se indexó desde fuentes públicas y no está marcada como oficial hasta que se apruebe una reclamación de mantenedor.

Creador
gosuda
Indexado por
Índice comunitario de OpenAgentSkill

La atribución enlaza al repositorio público o al perfil del creador. Los creadores pueden reclamar la ficha para actualizar las señales de propiedad.

Reclamar este skill

Reclamación del propietario

Reclamar esta ficha de skill

Esta ficha Indexado por Registry se atribuye a gosuda, pero aún no está marcada como oficial. Reclámala para añadir una señal de propietario verificado y hacer más fiables futuras actualizaciones de lanzamiento, instalación y auditoría.

Kit de enlaces para creadores

Añade las insignias de evidencia a tu README

Muestra la ficha canónica, las señales actuales de confianza y auditoría, y evidencia real de Agent-Proven donde los desarrolladores evalúan el repositorio.

[![Listed on OpenAgentSkill](https://www.openagentskill.com/api/badge/gosuda-relay-server-config?metric=listed&label=Listed)](https://www.openagentskill.com/skills/gosuda-relay-server-config)
[![OpenAgentSkill Trust](https://www.openagentskill.com/api/badge/gosuda-relay-server-config?metric=trust&label=Trust)](https://www.openagentskill.com/skills/gosuda-relay-server-config)
[![OpenAgentSkill Audit](https://www.openagentskill.com/api/badge/gosuda-relay-server-config?metric=audit&label=Audit)](https://www.openagentskill.com/skills/gosuda-relay-server-config/audit)
[![Agent Proven](https://www.openagentskill.com/api/badge/gosuda-relay-server-config?metric=proven&label=Agent%20Proven)](https://www.openagentskill.com/skills/gosuda-relay-server-config)

Autor

G

gosuda

@gosuda

Etiquetas

Afinidad con plataforma

Señales de salud

Estrellas de GitHub
263
Puntuación de calidad
40/100
Último push de GitHub
22 ago 2026
Pistas del framework
Desconocido
Vistas de OpenAgentSkill
0
Copias de instalación
0
Clics externos
0

Señal de comunidad

Comparte si este skill resulta útil para tu flujo de Agent. Los comentarios agregados mejoran la clasificación con el tiempo.

Confianza y seguridad

Solo sandbox

64
  • Adopción en GitHub263 estrellas de GitHubInfo
  • Actividad de stars/forks263 estrellas y 29 forks; la actividad de issues no está disponible en los metadatos actualesRevisar
  • Mantenimiento recienteActualizado hoyAprobado
  • Claridad de licenciaMITAprobado
  • Completitud de README/SKILL.mdLos metadatos incluyen suficiente contexto de uso y flujo de trabajoAprobado
  • Riesgo de dependencias/runtimecredential or environment access, external package install surfaceRevisar