Todo el procedimiento, desde un servidor vacío hasta un funcionamiento seguro: descargar el paquete, instalar, HTTPS, el primer inicio de sesión, la configuración y la protección del servidor. Qué debe cumplir el servidor está en el artículo Entorno compatible; de qué se compone una instalación lo describe Instalación en su propio servidor.
Antes de empezar
Tenga preparado:
- un servidor según el Entorno compatible y acceso a él por SSH con derechos de root (o
sudo), - el archivo de licencia
licence-<número>.jsonque le enviamos; contiene también la clave para descargar el paquete, - la dirección en la que las personas abrirán draften (por ejemplo,
https://draften.firma.cz) y la posibilidad de configurar un registro DNS para ella, - la decisión de dónde terminará HTTPS: directamente en draften (necesita un certificado y su clave en formato PEM), en su proxy inverso o en un Cloudflare Tunnel; consulte el paso 7,
- una clave de API de un modelo de lenguaje (Anthropic, OpenAI) o la dirección de su propio servidor compatible con OpenAI,
- los datos de un servidor SMTP desde el que draften enviará las invitaciones y los enlaces para establecer la contraseña (o una clave de API de Brevo).
Paso 1: Prepare el servidor
Instale Docker Engine con el plugin compose. En Ubuntu, desde el repositorio oficial de Docker:
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
En otras distribuciones, siga https://docs.docker.com/engine/install/. El paquete docker.io de los repositorios de la distribución suele ser antiguo y no tiene el plugin compose.
Compruebe las versiones: Docker debe ser la 24 o posterior y docker compose debe responder:
docker version --format '{{.Server.Version}}'
docker compose version
Paso 2: Descargue el paquete
El paquete se descarga de download.draften.ai con la clave que está dentro del archivo de licencia. Estos comandos extraen la clave de la licencia y muestran las versiones disponibles:
KEY=$(sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' licence-<número>.json | tr '_-' '/+' | awk '{ while (length($0) % 4) $0 = $0 "="; print }' | base64 -d | sed -n 's/.*"key": *"\([^"]*\)".*/\1/p')
curl -fsS -H "Authorization: Bearer $KEY" https://download.draften.ai/v1/latest.json | sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' | tr '_-' '/+' | awk '{ while (length($0) % 4) $0 = $0 "="; print }' | base64 -d
La lista muestra las versiones de los últimos seis meses (de cada una, la versión, la fecha, las notas, el tamaño y la suma de comprobación sha256) y, bajo latest, la más reciente que no se haya retirado. Descargue esa versión:
curl -fS -H "Authorization: Bearer $KEY" -o draften-<versión>.tar https://download.draften.ai/v1/bundles/draften-<versión>.tar
El paquete ocupa unos 500 MB. Si la pasarela responde con un error 403, la licencia es desconocida, está revocada o ha caducado; el mensaje dice por qué.
Servidor sin internet: descargue el paquete en otra máquina con los mismos comandos y cópielo al servidor (por ejemplo, con scp). En ese caso también podemos enviarle la suma de comprobación junto con el paquete.
Paso 3: Compruebe el paquete
Calcule la suma de comprobación y compárela con el valor sha256 de esa versión en la lista del paso 2:
sha256sum draften-<versión>.tar
Si las sumas no coinciden, no instale el paquete y póngase en contacto con nosotros. Esta es la única comprobación manual: cada actualización posterior la comprueba la instalación por sí sola con nuestras claves.
Paso 4: Descomprima el paquete y ejecute el instalador
Elija el directorio en el que vivirá la instalación, descomprima en él el paquete y ejecute el instalador:
sudo mkdir /srv/draften
sudo tar -xf draften-<versión>.tar -C /srv/draften
cd /srv/draften
sudo ./draften install
El instalador carga primero las imágenes (un minuto o dos) y comprueba la firma y el contenido del paquete. Si la comprobación falla («this bundle does not check out»), el paquete está dañado: vuelva a descargarlo.
Paso 5: Responda a las preguntas del instalador
El instalador pregunta en inglés:
| Pregunta | Qué indicar |
|---|---|
| Where will people open draften (the full address) | la dirección con https://, por ejemplo https://draften.firma.cz. Debe ser la dirección que las personas usan de verdad: con ella se construyen también las direcciones de redirección para iniciar sesión con Microsoft y Google |
| The organisation's name | el nombre de su organización |
| Its short name | un nombre corto: letras minúsculas, dígitos y guiones. Lo propone a partir del nombre de la organización |
| The first administrator's e-mail | el correo electrónico del primer administrador. Pasa a ser el propietario de la organización y el operador de toda la instalación |
| Their name | su nombre |
| Their language | cs, en, de, fr, es, it, pt o pl (en de forma predeterminada) |
| Run the updater | yes o no (yes de forma predeterminada). El updater permite actualizar, cambiar el número de procesos, cambiar la clave de cifrado y hacer copias de seguridad desde la interfaz web. Tiene acceso a Docker, es decir, derechos de root en el servidor. Sin él, todo funciona desde la línea de comandos |
| HTTPS certificate file (PEM) | la ruta del certificado, si HTTPS debe terminar directamente en draften; si no, déjelo vacío |
| Its private key file | la ruta de la clave del certificado |
Con certificado, la dirección debe empezar por https://. Cada respuesta también se puede dar directamente en el comando, así que puede automatizar la instalación con un script; ./draften help muestra las opciones:
sudo ./draften install --url https://draften.firma.cz --org "Firma S.L." \
--admin-email jan@firma.cz --admin-name "Jan Novák" --locale en --updater yes
Paso 6: Qué hace el instalador
- Escribe la configuración y los secretos en el archivo
.env, que solo puede leer su propietario. Las contraseñas de la base de datos, la clave de cifradoMASTER_KEYy el secreto de las sesiones los genera al azar y no los muestra en ningún sitio. - Crea las carpetas
data/ybackups/y la primera organización con su administrador. - Inicia draften y comprueba que responde.
- Al final muestra la dirección y el enlace para establecer la contraseña del primer administrador, y le recuerda que guarde una copia de
.env.
Si el primer inicio falla («the first start failed»), consulte docker compose ps y docker compose logs. Si no muestra el enlace, lo encontrará con el comando docker compose logs worker | grep set-password: el worker lo muestra en cada inicio mientras no exista la contraseña.
Guarde enseguida una copia de .env fuera del servidor, como mínimo el valor de MASTER_KEY. Con esta clave están cifrados el acceso a los buzones, las claves de los modelos y las contraseñas para enviar correo. Sin ella nadie puede leerlos, ni siquiera desde una copia de seguridad, y nosotros no la tenemos.
Paso 7: Publique draften a través de HTTPS
Según dónde termine HTTPS, elija una de las variantes. Dirija el registro DNS de su dirección al servidor (o al proxy).
HTTPS directamente en draften
Si le dio al instalador un certificado, draften escucha en el puerto 443 y redirige del puerto 80 a HTTPS. Basta con el DNS y los puertos 80 y 443 abiertos. El certificado también se puede añadir más tarde, y con el mismo comando lo sustituye tras renovarlo sin perder ni una sola solicitud:
sudo ./draften certificate cert.pem key.pem --url https://draften.firma.cz
La renovación del certificado (por ejemplo, con un cliente ACME) corre por su cuenta; después de cada renovación, ejecute este comando.
Su proxy inverso
Sin certificado, draften solo escucha en 127.0.0.1:8085. Un proxy en la misma máquina envía las solicitudes a esta dirección y transmite los encabezados Host y X-Forwarded-Proto. Por ejemplo, para Caddy (obtiene el certificado por sí mismo):
draften.firma.cz {
reverse_proxy 127.0.0.1:8085
}
o para nginx:
server {
listen 443 ssl;
server_name draften.firma.cz;
ssl_certificate /etc/ssl/draften/fullchain.pem;
ssl_certificate_key /etc/ssl/draften/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8085;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Si el proxy está en otra máquina, ponga WEB_BIND=0.0.0.0:8085 en .env, ejecute sudo docker compose up -d y haga accesible el puerto 8085 solo para el proxy (consulte el paso 13).
Cloudflare Tunnel
No necesita ningún puerto abierto. En Cloudflare Zero Trust, cree un túnel y copie su token. Ponga CLOUDFLARE_TUNNEL_TOKEN=<token> en .env, añada tunnel a COMPOSE_PROFILES (por ejemplo, COMPOSE_PROFILES=updater,tunnel) y ejecute:
sudo docker compose up -d
Después, en Cloudflare, añada al túnel una dirección pública (Public hostname) que lleve a http://127.0.0.1:8085. Deje WEB_BIND en 127.0.0.1:8085. La imagen cloudflared la descarga Docker de Docker Hub: no está en el paquete.
Paso 8: Establezca su contraseña e inicie sesión
Abra el enlace que mostró el instalador, establezca la contraseña y habrá iniciado sesión. El enlace funciona una sola vez y es válido durante 7 días. Cómo es la página para establecer la contraseña lo muestra la guía «Iniciar sesión».
No copie el enlace en ningún sitio ni lo reenvíe: quien lo tenga establece la contraseña del administrador.
Paso 9: Suba la licencia
En la interfaz, abra Instalación › Instalación, elija el archivo en la tarjeta Licencia, al final de la página, y súbalo. Mientras la instalación no tenga licencia, los asistentes no procesan correo y no se puede crear ningún buzón ni asistente. Con la licencia, el updater vigila por sí solo las versiones nuevas. Más información en el artículo La licencia.
Paso 10: Configure las claves y el envío de correo predeterminados
En la misma página Instalación:
- Claves de API predeterminadas: claves de los modelos para todas las organizaciones y los buzones que no tengan las suyas. Consulte Claves de API de los modelos.
- Envío de correo predeterminado: desde dónde salen las invitaciones y los enlaces para establecer la contraseña: Remitente (dirección), Remitente (nombre), Servidor SMTP, Puerto (587 de forma predeterminada), Cifrado (STARTTLS en el 587, TLS en el 465), Usuario y Contraseña, o una clave de API de Brevo. Con el botón Enviar un mensaje de prueba comprueba que el correo sale. Sin remitente no se envía a nadie ninguna invitación ni ningún enlace de contraseña. Consulte Envío de correo.
Paso 11: Conecte el correo y a las personas
- Decida cómo accederá el asistente al correo y prepárelo en Microsoft o Google: Microsoft 365, Google Workspace, u otro buzón mediante IMAP.
- Quién debe iniciar sesión con una cuenta de Microsoft o Google, configúrelo en Cómo inician sesión los miembros.
- Añada y conecte un buzón.
- Configure un asistente con la configuración guiada.
- Invite a más personas: Personas y roles.
Paso 12: Compruebe que todo funciona
sudo ./draften status
muestra la versión, el estado del servicio web y de los workers, el estado de HTTPS y de las copias de seguridad. En la interfaz, la página Funcionamiento muestra si los workers se reportan; consulte Funcionamiento y capacidad. Si algo no funciona, le ayudará Solución de problemas; el archivo para nuestro soporte lo crea sudo ./draften diagnose.
Paso 13: Proteja el servidor
Quien tiene acceso al servidor tiene acceso a todo: al correo de los mensajes, a .env con la clave y a las copias de seguridad. Por eso, proteja el servidor como si fuera un servidor de correo.
Cortafuegos. Desde fuera, permita solo lo necesario:
- con HTTPS en draften, los puertos 80 y 443,
- con un proxy inverso en otra máquina, el puerto 8085 solo desde la dirección del proxy,
- con un Cloudflare Tunnel, ninguno,
- SSH solo desde las direcciones desde las que administra el servidor.
Docker se salta las reglas de UFW (y de firewalld) en los puertos que publica. ufw deny 8085 no cierra un puerto que Docker abrió en 0.0.0.0. Por eso, deje WEB_BIND en 127.0.0.1:8085 siempre que se pueda; si no, limite el acceso con un cortafuegos delante del servidor o con reglas en la cadena DOCKER-USER.
Basta con permitir las conexiones salientes a las direcciones del Entorno compatible.
SSH. Inicio de sesión solo con clave (PasswordAuthentication no), sin inicio de sesión directo de root (PermitRootLogin no), y los administradores con cuentas propias y sudo.
Quién puede usar Docker. Pertenecer al grupo docker equivale a derechos de root. Déselo solo a los administradores del servidor.
Actualizaciones del sistema. Active las actualizaciones de seguridad automáticas (en Ubuntu, unattended-upgrades) y actualice Docker junto con el sistema. De las actualizaciones de draften se encarga el updater: consulte «Actualizar con el updater».
Updater. Tiene acceso a Docker, es decir, derechos de root. Si no lo necesita, desactívelo: quite updater de COMPOSE_PROFILES en .env y, en el directorio de la instalación, ejecute sudo docker compose rm -sf updater. Las actualizaciones y las copias de seguridad las hará entonces desde la línea de comandos.
Archivos de la instalación. .env solo lo puede leer su propietario, y la carpeta backups/ también: déjelo así. No comparta el directorio de la instalación.
Copias de seguridad fuera del servidor. draften hace cada día una copia de seguridad de la base de datos en backups/, en el mismo disco. Configure la copia de backups/ y .env a otro lugar, cifrada: los volcados contienen correo. Detalles: Copia de seguridad y restauración.
Clave de cifrado. Si se va alguien que conocía .env, sustituya MASTER_KEY (sudo ./draften rotate-key, o en la administración de la instalación) y guarde la nueva copia de .env fuera del servidor.
Siguientes pasos
- «Actualizar con el updater»: una versión nueva con un solo botón,
- Actualizar desde la línea de comandos,
- Copia de seguridad y restauración,
- Solución de problemas.