Tutoriales de VPS
OpenCode Web en VPS: SSH, contraseña y Caddy HTTPS (2026)
Instala OpenCode con usuario Ubuntu propio, autentica proveedor, mantiene servicio protegido y accede por SSH o HTTPS; verifica permisos, actualizaciones y recuperación.

OpenCode Web en VPS permite continuar desde un navegador dejando repositorio y credenciales en la máquina remota. Debes configurar persistencia, conexión protegida y permisos de archivos/comandos. Usamos Ubuntu y un desarrollador, primero SSH y después Caddy HTTPS opcional.
OpenCode es un coding agent abierto con interfaz web. Sin contraseña, el servidor local no protege acceso por defecto. Escucha en 127.0.0.1:4096 con túnel/proxy; no publiques 4096 directamente.
La inferencia corresponde al proveedor configurado; VPS ejecuta búsquedas, comandos, dependencias y builds. Instalar OpenCode no instala modelo local. 2 vCPU, 4 GB RAM y 20 GB libres sirven como punto de prueba para un repositorio pequeño, sin garantía ni mínimo oficial. Builds Node, pruebas y concurrencia necesitan recursos medidos. Comprueba free -h/df -h, artefactos y logs.
Usa usuario normal y workspace propio. No root ni secretos productivos, claves de nube o socket Docker accesibles. Contraseña web controla entrada, no permisos Linux del agente. Repositorios no confiables o usuarios distintos requieren VPS/contendedores aislados adecuadamente.
Prepara Ubuntu 24.04/26.04, SSH y credencial de proveedor. Administrador necesita sudo para instalar. Dominio solo para HTTPS.
Crea usuario sin sudo; omite adduser si existe y verifica /home/agent:
sudo apt update
sudo apt install -y curl git openssl
sudo adduser --disabled-password --gecos '' agent
sudo -iu agent
mkdir -p ~/workspaces
curl -fsSL https://opencode.ai/install | bash
~/.opencode/bin/opencode --version
El instalador oficial usa ~/.opencode/bin/. Revisa origen antes de ejecutarlo. En sesión del agente:
~/.opencode/bin/opencode auth login
~/.opencode/bin/opencode auth list
auth login selecciona proveedor y guarda credenciales en ~/.local/share/opencode/auth.json. No pongas claves en repositorio, ejemplos ni .env público. auth list confirma configuración, no cuota ni llamada; prueba petición pequeña en web. Mira proveedores para acceso/costes.
Clona/copia a ~/workspaces/你的项目 con permisos de agent. Empieza en pruebas con explicación y plan antes de cambios. exit vuelve a sesión administrativa.
La contraseña web no es API key del modelo. Como agent, genera secreto y archivo privado:
sudo -iu agent
install -d -m 700 ~/.config
umask 077
printf 'OPENCODE_SERVER_PASSWORD=%s\n' "$(openssl rand -hex 32)" > ~/.config/opencode-web.env
chmod 600 ~/.config/opencode-web.env
cat ~/.config/opencode-web.env
exit
El último comando muestra secreto: terminal privado y gestor de contraseñas, sin chat/Git. Unit supone /home/agent; adapta rutas absolutas. Crea /etc/systemd/system/opencode-web.service:
[Unit]
Description=OpenCode Web coding agent
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
User=agent
Group=agent
WorkingDirectory=/home/agent/workspaces
Environment=HOME=/home/agent
EnvironmentFile=/home/agent/.config/opencode-web.env
ExecStart=/home/agent/.opencode/bin/opencode web --hostname 127.0.0.1 --port 4096
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
Valida e inicia:
sudo systemd-analyze verify /etc/systemd/system/opencode-web.service
sudo systemctl daemon-reload
sudo systemctl enable --now opencode-web
sudo systemctl status opencode-web --no-pager
sudo ss -lntp | grep ':4096'
curl -I --max-time 5 http://127.0.0.1:4096/
ss debe indicar 127.0.0.1:4096; petición sin credencial debe dar 401. Así pruebas protección, no solo proceso. Revisa ocupante con ss ante conflicto. No cambies a --hostname 0.0.0.0 por comodidad. La guía web advierte acceso sin protección al omitir OPENCODE_SERVER_PASSWORD.
En tu ordenador, redirige 4096 al loopback remoto; cambia 你的SSH用户/VPS_IP:
ssh -N -L 4096:127.0.0.1:4096 你的SSH用户@VPS_IP
Mantén túnel y abre http://127.0.0.1:4096. Usuario predeterminado opencode y contraseña web. localhost es tu equipo. Si 4096 ocupado, cambia puerto izquierdo a 14096:127.0.0.1:4096 y abre http://127.0.0.1:14096. Verifica identidad SSH y listener local loopback. SSH cerrado corta navegador, no servicio systemd.
Solo usa puerto SSH existente. Para móvil/dominio fijo, HTTPS con personas confiables.
Apunta A/AAAA de agent.example.com al VPS, permite 80/443 y revisa servicios existentes. 4096 queda privado. Instala según Caddy Ubuntu:
sudo apt install --yes debian-keyring debian-archive-keyring apt-transport-https curl gnupg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy
Añade sitio a /etc/caddy/Caddyfile, sin sobrescribir otros:
agent.example.com {
reverse_proxy 127.0.0.1:4096
}
Valida y recarga:
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://agent.example.com/
DNS/puertos correctos permiten HTTPS automático. Backend sigue local con Basic Auth. HTTPS no autentica usuarios: conserva OPENCODE_SERVER_PASSWORD. Entrada compartida comparte proyectos/credenciales del mismo usuario Linux; separa instancias para permisos distintos. Proxy en otro host/contenedor necesita backend privado alcanzable, no asumir localhost común.
En repositorio de prueba, pide explicación/plan, revisa cambio pequeño con git diff. No entregues entorno productivo ni secretos de pagos/base. Comprueba:
sudo systemctl is-active opencode-web
sudo journalctl -u opencode-web -n 80 --no-pager
sudo ss -lntp | grep ':4096'
sudo -iu agent /home/agent/.opencode/bin/opencode auth list
No abre navegador: systemctl status, journalctl y listener 4096; túnel activo o DNS/firewall/80/443/logs Caddy.
Pide contraseña siempre: usa secreto web, no key de modelo. Cambiar opencode-web.env exige sudo systemctl restart opencode-web.
Modelo falla: auth list como agent, cuota, modelo y red de salida.
Repositorio ausente/sin escritura: ruta y permisos de agent; no lo resuelvas con sudo.
Antes de actualizar, copia proyectos y ~/.local/share/opencode/. Ejecuta instalador como agent, verifica versión y reinicia. Si falla, detén servicio y recupera versión probada según opciones oficiales. Git remoto y copia externa siguen necesarios; mira snapshot/backup.
¿GPU? No para modelo cloud. Inferencia local es otro despliegue.
¿Publicar 4096? Prefiere loopback y SSH/HTTPS autenticado, siempre contraseña web.
¿Cerrar navegador para tareas? No detiene systemd; tarea depende de sesión/proceso. Revisa cambios, no supongas éxito.
¿Agentes de terminal? Mira Codex CLI y Claude Code VPS. Aquí se prepara específicamente OpenCode Web persistente y protegido.