Instalación de Code-Server

Configuración

Ahora que Code-Server y Caddy están instalados, los configuraremos para que trabajen juntos, proporcionaremos acceso a través de un nombre de dominio y automatizaremos la obtención de certificados SSL.

1. Configuración de Code-Server

Code-Server crea un archivo de configuración por defecto o utiliza variables de entorno. Para nuestro caso, utilizaremos el archivo de configuración que fue creado por el script de instalación. Se encuentra en ~/.config/code-server/config.yaml.

# Abra el archivo de configuración de Code-Server
nano ~/.config/code-server/config.yaml

En este archivo, puede configurar parámetros como la contraseña para acceder al IDE. Busque o añada las siguientes líneas:

bind-addr: 127.0.0.1:8080
auth: password
password: "SU_CONTRASEÑA_SEGURA" # ¡Asegúrese de reemplazarla por una contraseña robusta!
cert: false

• bind-addr: 127.0.0.1:8080: Code-Server escuchará solo en la interfaz local, lo cual es seguro, ya que Caddy actuará como proxy para las solicitudes.
• auth: password: Habilita la autenticación por contraseña.
• password: "SU_CONTRASEÑA_SEGURA": Establezca una contraseña muy segura.
• cert: false: Deshabilitamos el HTTPS integrado de Code-Server, ya que Caddy se encargará del SSL.

Guarde el archivo (Ctrl+O, Enter, Ctrl+X) y reinicie Code-Server para aplicar los cambios:

sudo systemctl restart code-server@вашпользователь

2. Configuración de Caddy para proxy y SSL

Caddy utiliza el archivo Caddyfile para su configuración, ubicado en /etc/caddy/Caddyfile.

# Abra Caddyfile para editar
sudo nano /etc/caddy/Caddyfile

Elimine todo el contenido existente y añada la siguiente configuración, reemplazando code.вашдомен.com por su dominio real:

code.вашдомен.com {
    reverse_proxy 127.0.0.1:8080 {
        # Encabezados necesarios para el correcto funcionamiento de WebSocket y otras funciones de Code-Server
        header_up Host {host}
        header_up X-Real-IP {remote_ip}
        header_up X-Forwarded-For {remote_ip}
        header_up X-Forwarded-Proto {scheme}
    }

    # Habilitar compresión (gzip) para archivos estáticos
    encode gzip

    # Encabezados de seguridad adicionales (opcional, pero recomendado)
    header {
        Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"
        X-Content-Type-Options "nosniff"
        X-Frame-Options "DENY"
        X-XSS-Protection "1; mode=block"
        Referrer-Policy "strict-origin-when-cross-origin"
    }
}

Guarde el archivo y reinicie Caddy para que aplique la nueva configuración y obtenga un certificado SSL de Let's Encrypt:

# Verificación de la sintaxis de Caddyfile antes de reiniciar
sudo caddy validate --config /etc/caddy/Caddyfile

# Reinicio de Caddy para aplicar la nueva configuración
sudo systemctl reload caddy

Caddy intentará automáticamente obtener un certificado SSL para su dominio. Si surgen problemas, verifique que su registro DNS A apunte correctamente a la dirección IP del servidor y que los puertos 80/443 estén abiertos en UFW.

3. Verificación del funcionamiento

Después de configurar y reiniciar Caddy, abra su navegador web y vaya a https://code.вашдомен.com. Debería ver la página de inicio de sesión de Code-Server. Ingrese la contraseña que estableció en config.yaml.

Si encuentra problemas, verifique los registros de Caddy y Code-Server:

# Ver registros de Caddy
journalctl -u caddy --no-pager

# Ver registros de Code-Server
journalctl -u code-server@вашпользователь --no-pager

También puede verificar si Code-Server está escuchando en el puerto 8080:

sudo ss -tuln | grep 8080

Y asegurarse de que Caddy esté escuchando en los puertos 80 y 443:

sudo ss -tuln | grep -E "80|443"

Si todo está configurado correctamente, tendrá acceso a un entorno completo de VS Code en su navegador con una conexión HTTPS segura.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno del servidor son clave para un funcionamiento estable y seguro de su entorno de desarrollo.

1. Qué respaldar

Para Code-Server y su entorno de desarrollo asociado, es importante respaldar los siguientes componentes:

• Proyectos y archivos de trabajo: Todos sus repositorios, código fuente, datos que crea o modifica. Esto generalmente se encuentra en el directorio de inicio del usuario (/home/вашпользователь/) o en carpetas dedicadas.
• Configuración de Code-Server: El archivo ~/.config/code-server/config.yaml, así como la carpeta ~/.local/share/code-server/, que contiene las extensiones instaladas, la configuración del usuario y la caché.
• Configuración de Caddy: El archivo /etc/caddy/Caddyfile.
• Configuración del sistema: Configuraciones importantes del sistema si ha realizado cambios en ellas (por ejemplo, /etc/ssh/sshd_config, /etc/fail2ban/jail.local, /etc/ufw/).
• Bases de datos: Si utiliza bases de datos locales (PostgreSQL, MySQL), asegúrese de hacer volcados de las mismas.

2. Script simple de copia de seguridad automática con Restic

Restic es un programa de copia de seguridad moderno, rápido y seguro que admite cifrado y deduplicación de datos. Puede guardar copias de seguridad en varios almacenamientos, incluidos objetos compatibles con S3, SFTP, Backblaze B2 y otros.

Instalación de Restic:

# Загрузка последней версии Restic (актуальная на 2026 год, например, 0.17.0)
wget https://github.com/restic/restic/releases/download/v0.17.0/restic_0.17.0_linux_amd64.bz2
bzip2 -d restic_0.17.0_linux_amd64.bz2
sudo mv restic_0.17.0_linux_amd64 /usr/local/bin/restic
sudo chmod +x /usr/local/bin/restic

Inicialización del repositorio Restic:

Cree un directorio para los scripts de copia de seguridad e inicialice el repositorio. Por ejemplo, utilizaremos un almacenamiento compatible con S3 (por ejemplo, Backblaze B2, DigitalOcean Spaces u otro VPS con MinIO).

mkdir ~/backups
nano ~/backups/backup.sh

Contenido de backup.sh (reemplace los placeholders con sus datos):

#!/bin/bash

# Переменные окружения для Restic
export RESTIC_REPOSITORY="s3:https://s3.ВАШ_S3_РЕГИОН.com/ВАШ_S3_БАКЕТ"
export AWS_ACCESS_KEY_ID="ВАШ_S3_КЛЮЧ_ДОСТУПА"
export AWS_SECRET_ACCESS_KEY="ВАШ_S3_СЕКРЕТНЫЙ_КЛЮЧ"
export RESTIC_PASSWORD="ВАШ_СЛОЖНЫЙ_ПАРОЛЬ_ДЛЯ_БЭКАПОВ" # Отдельный пароль для шифрования бэкапов

# Инициализация репозитория (выполнить один раз вручную)
# restic init

# Создание снапшота
restic backup \
    /home/вашпользователь \
    /etc/caddy/Caddyfile \
    /etc/ssh/sshd_config \
    --exclude-file=/home/вашпользователь/.cache \
    --exclude-file=/home/вашпользователь/.npm \
    --exclude-file=/home/вашпользователь/.vscode-server \
    --tag code-server-daily

# Очистка старых снапшотов (хранить последние 7 дней, 4 недели, 12 месяцев, 1 год)
restic forget \
    --keep-daily 7 \
    --keep-weekly 4 \
    --keep-monthly 12 \
    --keep-yearly 1 \
    --prune

# Проверка репозитория (опционально)
restic check

Haga que el script sea ejecutable:

chmod +x ~/backups/backup.sh

IMPORTANTE: Ejecute restic init manualmente UNA vez para crear el repositorio. Después de eso, comente esta línea en el script.

3. Dónde almacenar las copias de seguridad

Nunca almacene las copias de seguridad en el mismo servidor que los datos originales. Utilice:

• Almacenamiento externo compatible con S3: Backblaze B2, DigitalOcean Spaces, AWS S3. Es relativamente económico y fiable.
• VPS separado: Puede configurar un segundo VPS menos potente y usarlo como servidor SFTP para almacenar copias de seguridad.
• Almacenamiento en red (NAS): Si tiene su propio NAS, puede configurar el acceso SFTP a él.

4. Automatización de copias de seguridad con Cron

Agregue el script al programador Cron para su ejecución diaria.

crontab -e

Agregue la siguiente línea al final del archivo para que el script se ejecute todos los días a las 3:00 de la madrugada:

0 3 * * * /home/вашпользователь/backups/backup.sh >> /home/вашпользователь/backups/backup.log 2>&1

5. Actualizaciones: rolling vs maintenance window

• Actualizaciones del SO: Ejecute regularmente sudo apt update && sudo apt upgrade -y. Las actualizaciones críticas del kernel pueden requerir un reinicio del servidor. Planifíquelo para el momento de menor actividad.
• Actualizaciones de Code-Server: Para actualizar Code-Server a una nueva versión (por ejemplo, de 4.20.0 a 4.21.0) puede volver a ejecutar el script de instalación con la nueva versión:

  
              curl -fsSL https://code-server.dev/install.sh | sh -s -- --version 4.21.0
              sudo systemctl restart code-server@вашпользователь
              

  Se recomienda revisar los registros en busca de errores después de la actualización.
• Actualizaciones de Caddy: Caddy se actualiza a través del gestor de paquetes: sudo apt update && sudo apt upgrade caddy -y. Después de la actualización, Caddy se reiniciará automáticamente para aplicar los cambios.

Siempre haga una copia de seguridad antes de las actualizaciones importantes, especialmente antes de actualizar el SO o Code-Server.

Resolución de problemas + Preguntas frecuentes

Aquí encontrará respuestas a preguntas frecuentes y soluciones a problemas típicos que puede encontrar al configurar Code-Server.

Code-Server no se inicia o no está disponible

Qué verificar:

1. Verifique el estado del servicio Code-Server: systemctl status code-server@вашпользователь.
2. Revise los registros de Code-Server: journalctl -u code-server@вашпользователь --no-pager.
3. Asegúrese de que Code-Server esté escuchando en el puerto 8080: sudo ss -tuln | grep 8080.
4. Verifique la configuración en ~/.config/code-server/config.yaml en busca de errores.

Cómo solucionar: Corrija los errores encontrados en los registros. Asegúrese de que bind-addr esté configurado en 127.0.0.1:8080 y que la contraseña sea correcta. Reinicie el servicio: sudo systemctl restart code-server@вашпользователь.

No se puede acceder a Code-Server a través del dominio (Caddy no funciona)

Qué verificar:

1. Verifique el estado del servicio Caddy: systemctl status caddy.
2. Revise los registros de Caddy: journalctl -u caddy --no-pager.
3. Asegúrese de que Caddy esté escuchando en los puertos 80 y 443: sudo ss -tuln | grep -E "80|443".
4. Verifique la validez de su Caddyfile: sudo caddy validate --config /etc/caddy/Caddyfile.
5. Asegúrese de que el registro DNS A para su dominio (por ejemplo, code.вашдомен.com) apunte a la dirección IP de su VPS.
6. Verifique que UFW permita los puertos 80 y 443: sudo ufw status verbose.

Cómo solucionar: Corrija los errores en el Caddyfile, actualice los registros DNS si son incorrectos o abra los puertos en UFW. Reinicie Caddy: sudo systemctl reload caddy.

El certificado SSL no se emite

Qué verificar:

1. Asegúrese de que su dominio se resuelva correctamente a la dirección IP del servidor (puede usar dig code.вашдомен.com).
2. Asegúrese de que los puertos 80 y 443 estén abiertos en UFW y no estén ocupados por otra aplicación.
3. Revise los registros de Caddy en busca de errores de Let's Encrypt.

Cómo solucionar: Resuelva los problemas de DNS o del firewall. Caddy intentará obtener un certificado automáticamente al reiniciar. Si el problema persiste, es posible que tenga un límite en la cantidad de certificados de Let's Encrypt (raro para un dominio nuevo).

Rendimiento lento de Code-Server

Qué verificar:

1. Carga de CPU y RAM en el servidor: htop o top.
2. Velocidad del subsistema de disco (si los proyectos son grandes).
3. Extensiones de VS Code: algunas extensiones pueden consumir muchos recursos. Intente deshabilitarlas.
4. Conexión de red entre su cliente y el VPS: verifique el ping.

Cómo solucionar: Considere actualizar el VPS (más CPU/RAM, NVMe SSD). Optimice el código de los proyectos. Deshabilite las extensiones no utilizadas. Verifique la estabilidad de su conexión a Internet.

¿Cuál es la configuración mínima de VPS adecuada?

Para un solo usuario y proyectos pequeños, un VPS con 2 vCPU, 2-4 GB de RAM y 40-60 GB de SSD NVMe será suficiente. Esto bastará para el trabajo básico con la mayoría de los lenguajes de programación sin ejecutar procesos en segundo plano pesados. Sin embargo, para un trabajo más cómodo y proyectos de complejidad media, se recomienda 4 vCPU, 8 GB de RAM y más de 80 GB de SSD NVMe.

¿Qué elegir: VPS o dedicado para esta tarea?

Para la mayoría de los desarrolladores individuales, fundadores en solitario o equipos pequeños (hasta 3-5 personas), un VPS es la opción óptima. Es económico y proporciona suficiente potencia. Un servidor dedicado debe considerarse si tiene proyectos muy grandes y que consumen muchos recursos, que requieren el máximo rendimiento, o si está implementando Code-Server para un equipo grande (más de 10 personas), donde se requiere un aislamiento completo de los recursos y la personalización del hardware. En otros casos, un VPS será una solución más flexible y económica.

Conclusiones y próximos pasos

¡Felicidades! Ha configurado Code-Server con éxito en su VPS, lo que le permite acceder a un entorno de desarrollo completo de Visual Studio Code desde cualquier navegador, protegido con SSL/TLS. También ha implementado medidas de seguridad básicas y ha configurado copias de seguridad automáticas, lo que hace que su entorno de trabajo sea fiable y seguro.

Ahora tiene una herramienta potente, flexible y totalmente controlada para el desarrollo remoto. Pero las posibilidades no terminan aquí. Aquí hay algunos pasos siguientes que puede considerar:

• Integración con Git: Si aún no lo ha hecho, clone sus repositorios Git en el VPS y comience a utilizar activamente las capacidades integradas de VS Code para trabajar con el control de versiones.
• Instalación de Docker: Para proyectos más complejos, considere instalar Docker en su VPS. Esto le permitirá ejecutar entornos aislados para el desarrollo, prueba y despliegue de aplicaciones, sin contaminar el sistema principal.
• Automatización del despliegue: Configure pipelines de CI/CD (por ejemplo, con GitLab CI/CD, GitHub Actions o Jenkins) para probar y desplegar automáticamente sus proyectos directamente desde el VPS.
• Monitoreo del servidor: Instale herramientas de monitoreo (por ejemplo, Prometheus + Grafana, Netdata) para rastrear el rendimiento de su VPS y detectar problemas a tiempo.