Tutoriais de VPS
OpenCode Web no VPS: SSH, senha e Caddy HTTPS (2026)
Instale OpenCode com usuário Ubuntu próprio, autentique provedor, mantenha serviço protegido e acesse por SSH ou HTTPS; valide permissões, atualizações e recuperação.

OpenCode Web no VPS permite continuar pelo navegador mantendo repositório e credenciais na máquina remota. Configure persistência, conexão protegida e permissões de arquivos/comandos. Usamos Ubuntu e um desenvolvedor, primeiro SSH e depois Caddy HTTPS opcional.
OpenCode é coding agent aberto com interface web. Sem senha, servidor local não protege acesso por padrão. Mantenha 127.0.0.1:4096 com túnel/proxy; não publique 4096 diretamente.
Inferência fica no provedor configurado; VPS executa buscas, comandos, dependências e builds. Instalar OpenCode não instala modelo local. 2 vCPU, 4 GB RAM e 20 GB livres são ponto de teste para repositório pequeno, sem garantia ou mínimo oficial. Builds Node, testes e concorrência exigem recursos medidos. Confira free -h/df -h, artefatos e logs.
Use usuário comum e workspace próprio. Sem root nem segredos produtivos, chaves cloud ou socket Docker acessíveis. Senha web controla entrada, não permissões Linux do agente. Repositórios não confiáveis ou usuários distintos exigem VPS/contêineres isolados adequadamente.
Prepare Ubuntu 24.04/26.04, SSH e credencial do provedor. Administrador precisa de sudo para instalação. Domínio só para HTTPS.
Crie usuário sem sudo; pule adduser se já existe e confira /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
O instalador oficial usa ~/.opencode/bin/. Revise origem antes de executar. Na sessão do agente:
~/.opencode/bin/opencode auth login
~/.opencode/bin/opencode auth list
auth login escolhe provedor e guarda credenciais em ~/.local/share/opencode/auth.json. Não coloque keys em repositório, exemplos ou .env público. auth list confirma configuração, não quota ou chamada; teste pedido pequeno na web. Veja provedores para acesso/custos.
Clone/copie para ~/workspaces/你的项目 com acesso de agent. Comece em teste com explicação/plano antes de escrita. exit retorna à sessão administrativa.
Senha web não é API key do modelo. Como agent, gere segredo e arquivo 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
Último comando exibe segredo: use terminal privado/gerenciador, sem Git/chat. Unit pressupõe /home/agent; adapte caminhos absolutos. Crie /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
Valide e inicie:
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 deve indicar 127.0.0.1:4096; chamada sem credencial deve retornar 401. Isso testa proteção, não só processo. Identifique ocupante com ss em conflito. Não mude para --hostname 0.0.0.0 por facilidade. A guia web informa ausência de proteção sem OPENCODE_SERVER_PASSWORD.
No seu computador, encaminhe 4096 ao loopback remoto, substituindo 你的SSH用户/VPS_IP:
ssh -N -L 4096:127.0.0.1:4096 你的SSH用户@VPS_IP
Mantenha túnel e abra http://127.0.0.1:4096. Usuário padrão opencode e senha web. localhost é seu computador. Se 4096 ocupado, troque porta esquerda por 14096:127.0.0.1:4096 e abra http://127.0.0.1:14096. Confira identidade SSH e listener local loopback. Fechar SSH corta navegador, não systemd.
Só utiliza SSH existente. Para celular/domínio fixo, considere HTTPS limitado a pessoas confiáveis.
Aponte A/AAAA de agent.example.com ao VPS, permita 80/443 e confira serviços existentes. 4096 segue privado. Instale por 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
Adicione site a /etc/caddy/Caddyfile, sem sobrescrever outros:
agent.example.com {
reverse_proxy 127.0.0.1:4096
}
Valide e recarregue:
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://agent.example.com/
DNS/portas corretos permitem HTTPS automático. Backend local mantém Basic Auth. HTTPS não autentica usuário: preserve OPENCODE_SERVER_PASSWORD. Entrada compartilhada compartilha projetos/credenciais do usuário Linux; separe instâncias para permissões diferentes. Proxy em outro host/contêiner exige backend privado alcançável, sem presumir localhost comum.
Num repositório de teste, peça explicação/plano e confira mudança pequena com git diff. Não entregue ambiente produtivo ou segredos de pagamento/banco. Confira:
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
Navegador não abre: systemctl status, journalctl, listener 4096; túnel ativo ou DNS/firewall/80/443/logs Caddy.
Senha repetida: use senha web, não key do modelo. Alterar opencode-web.env exige sudo systemctl restart opencode-web.
Modelo falha: auth list como agent, quota, modelo e saída de rede.
Repositório ausente/sem escrita: caminho/permissões de agent; sudo não resolve o limite corretamente.
Antes de atualizar, copie projetos e ~/.local/share/opencode/. Rode instalador como agent, confira versão e reinicie. Se falha, pare e restaure versão testada pelas opções oficiais. Git remoto e backup externo continuam necessários; veja snapshot/backup.
GPU? Não para modelo cloud. Inferência local é outra instalação.
Publicar 4096? Prefira loopback e SSH/HTTPS autenticado, sempre senha web.
Fechar navegador para tarefas? Não para systemd; tarefa depende de sessão/processo. Confira alterações antes de presumir conclusão.
Agentes de terminal? Veja Codex CLI e Claude Code VPS. Este roteiro prepara especificamente OpenCode Web persistente e protegido.