Tutoriales de VPS
Gemini CLI en VPS: API key, SSH, tmux y aislamiento (2026)
Instala Gemini CLI con usuario Ubuntu normal y Node compatible, autentica sin escritorio con API key, retoma tmux y revisa permisos, cuota, actualizaciones y cambios.

Gemini CLI en VPS suele depender más de Node.js, autenticación sin escritorio y continuidad SSH que de npm install. Cubrimos un desarrollador, Ubuntu y modelos cloud: usuario normal, runtime compatible, API key y sesión tmux.
CLI lee repositorio y ejecuta herramientas permitidas; peticiones van al servicio Google elegido. No es modelo Gemini local. No necesitas puerto web: acceso remoto sigue por SSH.
La instalación oficial exige Node.js 20+ e internet; recomienda 4 GB+ RAM para sesiones cortas y 16 GB+ para sesiones largas/repositorios grandes. No garantiza rendimiento. Añade recursos para builds, pruebas, Docker y concurrencia.
Comprueba SSH, npm y modelo antes de contratar largo plazo. Revisa regiones AI Studio/API, derechos y cuotas. Separa agentes de producción; usuario de ejemplo no pertenece a sudo.
En Ubuntu 24.04/26.04, administrador necesita sudo. Crea coder si falta:
sudo apt update
sudo apt install -y curl git tmux ca-certificates
sudo adduser --disabled-password --gecos '' coder
sudo -iu coder
Después trabaja como coder. Node del sistema puede ser antiguo: node -v, no solo éxito de apt install nodejs. nvm instala LTS del usuario sin sudo npm global:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
nvm install --lts
nvm alias default 'lts/*'
node -v
npm -v
Confirma node -v al menos 20 e instala estable @google/gemini-cli:
npm install -g @google/gemini-cli
gemini --version
command -v gemini
Si faltan nvm/gemini al reconectar, . "$HOME/.nvm/nvm.sh" como coder y revisa nvm en ~/.bashrc. No uses sudo npm install -g mezclando instalación root y usuario normal.
La guía de autenticación explica API key y Vertex AI. El aviso específico para Code Assist individual indica que Login with Google ya no está disponible para cuentas consumidoras afectadas, incluido CLI. Páginas generales pueden conservar recomendaciones antiguas: comprueba tu tipo de cuenta. Aquí usamos key de AI Studio. Revisa región, cuota y costes; nunca pongas keys en Git/tickets/chat. Organizaciones y Vertex AI tienen métodos propios.
Como coder, crea archivo 600 mediante entrada oculta. Son comandos Bash: %q cita el valor para cargarlo de forma segura sin key literal en historial.
install -d -m 700 "$HOME/.config/gemini-cli"
read -r -s -p '粘贴 Gemini API Key: ' gemini_api_key
printf '\n'
umask 077
printf 'export GEMINI_API_KEY=%q\n' "$gemini_api_key" > "$HOME/.config/gemini-cli/key.sh"
unset gemini_api_key
chmod 600 "$HOME/.config/gemini-cli/key.sh"
. "$HOME/.config/gemini-cli/key.sh"
test -n "${GEMINI_API_KEY:-}" && echo 'API Key 已加载'
key.sh queda fuera de Git. Presupuestos/alertas no siempre bloquean gasto. Si hay fuga, rota en proveedor y actualiza archivo. Elige Use Gemini API key cuando se pregunte. Prueba en repositorio desechable:
mkdir -p "$HOME/workspaces/demo"
cd "$HOME/workspaces/demo"
git init
printf '# VPS Gemini CLI 测试仓库\n' > README.md
gemini -p '只用一句话说明当前仓库有什么文件,不要修改文件'
El ejemplo pide describir archivos en una frase sin cambios; usa equivalente en tu idioma. Esa petición no es aislamiento de archivos. -p activa modo headless. Ante región/cuota, revisa cuenta antes de reinstalar. Clona como coder en ~/workspaces/ con credencial limitada al repositorio, sin copiar tu clave privada principal.
Desconexión SSH puede terminar proceso frontal; tmux lo mantiene. Como coder:
tmux new -s gemini
export NVM_DIR="$HOME/.nvm"
. "$NVM_DIR/nvm.sh"
. "$HOME/.config/gemini-cli/key.sh"
cd "$HOME/workspaces/demo"
gemini
Ctrl-b y d separan sesión sin cerrarla. Después usa sudo -iu coder y:
tmux ls
tmux attach -t gemini
Si tmux ls no encuentra server, verifica usuario y si sesión terminó. tmux no restaura automáticamente tras reboot ni automatiza trabajo continuo. Después reinicia proyecto/credenciales y revisa Git.
La guía shell describe confirmaciones, también dependientes de modo/política. Empieza por explicación/plan y luego aprueba cambios o dependencias. No habilites aprobación universal, especialmente junto a producción.
Usuario normal no es sandbox completo. coder lee archivos permitidos. Aleja .env productivo, backups y claves cloud; sin sudo. Para más aislamiento, revisa sandbox Docker/Podman y montajes. Grupo Docker de coder puede dar control del host.
Revisa git status, git diff y pruebas reales antes de commit. Git remoto/copia externa siguen necesarios; mira snapshots y backups.
gemini: command not found: node -v, command -v npm, command -v gemini; carga ~/.nvm/nvm.sh como coder, sin root.
Login navegador no disponible: aviso de consumidor afecta esa vía. Usa API key y verifica test -n "${GEMINI_API_KEY:-}"; Vertex AI configurado es otra opción headless. Copiar tokens de navegador no es solución universal.
401/cuota/modelo: proyecto, región, permisos, cuota y salida. Autenticación válida no garantiza disponibilidad; consulta límites/precios.
Proyecto distinto al reconectar: pwd/git status y ruta; tmux attach conserva directorio previo. Sin cambios, revisa git diff y salida: sesión activa no equivale a tarea completa.
Antes de actualizar, registra gemini --version, copia proyecto y ~/.gemini/ como coder, ejecuta npm install -g @google/gemini-cli@latest, verifica versión/petición. Consulta releases y vuelve a versión probada ante regresión; evita previews en producción.
¿GPU? No para modelos cloud. Dimensiona herramientas/repositorios.
¿Cuenta personal con Google? El aviso de consumidores afecta Login with Google individual. Aquí key; organizaciones Code Assist Standard/Enterprise y Vertex AI siguen su método autorizado.
¿tmux programa todo el día? Solo conserva terminal; automatización exige triggers, permisos, logs y fallos propios.
¿Otros agentes? Aquí resolvemos Node y autenticación Gemini. Consulta Codex CLI y Claude Code para sus flujos.