Arkvory

Inicio rápido ​

Esta página muestra el camino más corto desde cero hasta un servidor Arkvory en funcionamiento con un archivo subido. Elija un método de instalación en el paso 1 y siga los demás pasos en orden.

Descargue los instaladores solo de la página de versiones del proyecto y compare su SHA-256 con los archivos de sumas de comprobación de la versión.

Paso 1. Instalar el servidor ​

Windows ​

Necesita Windows 10 versión 1809 o posterior, o Windows Server 2019 o posterior, en x64, y derechos de administrador. No se necesita conexión a internet.

  1. Ejecute Arkvory-Setup-x64.exe y confirme la solicitud de permisos de administrador.
  2. Elija el idioma y acepte la licencia.
  3. En la página del propietario, introduzca un nombre (3–64 letras latinas, dígitos, ., - o _) y una contraseña de al menos 12 caracteres. Es la primera cuenta de administrador.
  4. Finalice el asistente. Este puede abrir la consola por usted.

El instalador instala el programa en C:\Program Files\ProAnima\Arkvory y los datos en C:\ProgramData\ProAnima\Arkvory. Crea cuatro servicios de Windows: Arkvorydatabase, Arkvoryapi, Arkvoryworker y Arkvorybackup. Se ejecutan sin un usuario con sesión iniciada. Consulte Windows.

Linux ​

Use el paquete de su distribución. El administrador de paquetes también instala el servidor PostgreSQL (se admiten las versiones 16 a 19).

bash
# Debian, Ubuntu
sudo apt install ./Arkvory-amd64.deb

# Fedora, compatibles con RHEL
sudo dnf install ./Arkvory-x86_64.rpm

La raíz de la instalación es /opt/proanima-arkvory. El paquete crea los servicios de systemd arkvory-database, arkvory-api, arkvory-worker y arkvory-backup. Compruébelos:

bash
systemctl status arkvory-api arkvory-worker arkvory-backup

Consulte Linux.

Docker Compose ​

Necesita Docker con Compose. En Windows, use Docker Desktop con contenedores Linux. El script descarga Node.js y la versión, por lo que necesita acceso a internet.

Descargue install.sh o install.ps1 de la versión y léalo antes de ejecutarlo.

bash
sudo bash ./install.sh --mode compose

En Windows, ejecute PowerShell con el mismo usuario que ejecuta Docker Desktop, sin derechos de administrador:

powershell
.\install.ps1 -Mode compose

La raíz de la instalación es /opt/proanima-arkvory en Linux y C:\ProgramData\ProAnima\Arkvory en Windows. El conjunto incluye la API, el worker, el agente de copias de seguridad y PostgreSQL 18. Consulte Docker.

Paso 2. Abrir la consola ​

Abra http://127.0.0.1:8080/console/ en un navegador del propio servidor.

Al principio, el servidor escucha solo en la dirección local 127.0.0.1. Para abrir la consola desde su propio equipo, redirija el puerto mediante SSH:

bash
ssh -L 8080:127.0.0.1:8080 admin@arkvory.example

Después abra http://127.0.0.1:8080/console/ en su equipo. Para dar acceso a otros equipos, configure antes HTTPS.

Paso 3. Crear el propietario ​

En Windows, omita este paso: el instalador ya ha creado al propietario.

En Linux y Docker, la primera cuenta se crea con la clave de recuperación. El instalador la escribe en config/bootstrap-token.txt, dentro de la raíz de la instalación. Solo un administrador puede leer el archivo.

bash
sudo cat /opt/proanima-arkvory/config/bootstrap-token.txt
powershell
Get-Content C:\ProgramData\ProAnima\Arkvory\config\bootstrap-token.txt
  1. En la consola, abra Primeros pasos y expanda Crear el primer propietario.
  2. Pegue la clave en Clave de recuperación.
  3. Introduzca el nombre del propietario y una contraseña de al menos 12 caracteres, y seleccione Crear propietario.
  4. Inicie sesión con el nuevo nombre y la nueva contraseña en la tarjeta Conexión al repositorio.

Mantenga en secreto la clave de recuperación y no elimine el archivo. Las herramientas de instalación y de actualización lo usan. Consulte Seguridad.

El propietario es administrador y puede escribir en el repositorio releases. Para crear otro repositorio, abra Usuarios y acceso, expanda Administrar acceso a repositorios, conceda al grupo arkvory-owners el acceso Lectura y escritura a un nombre nuevo, como builds, y seleccione Guardar acceso. El nombre de un repositorio usa letras latinas minúsculas, dígitos, - y _, y tiene como máximo 64 caracteres.

Paso 4. Crear una clave para sus herramientas ​

Los scripts y el cliente de línea de comandos necesitan una clave. Para una primera prueba, use un token de acceso personal:

  1. Expanda Tokens de acceso personal en la tarjeta Conexión al repositorio.
  2. Introduzca un nombre en Nombre del token, establezca Acceso en Lectura y escritura y seleccione Generar token.
  3. Copie el token. Solo se muestra una vez.
  4. Guárdelo en un archivo que solo usted pueda leer, por ejemplo ~/.arkvory/key.

Para CI/CD y agentes de despliegue, cree en su lugar una cuenta de servicio con su propia clave. Consulte Cuentas y acceso.

Paso 5. Subir y descargar con curl ​

Una ruta de archivo de un repositorio funciona como un archivo en un servidor web. PUT almacena una versión nueva de la ruta y GET devuelve la versión actual.

bash
export ARKVORY_KEY="$(cat ~/.arkvory/key)"

# Subida
curl -T ./Setup.exe -H "Authorization: Bearer $ARKVORY_KEY" \
  http://127.0.0.1:8080/api/v1/repositories/releases/raw/builds/game/1.0/Setup.exe

# Descarga
curl -fL -H "Authorization: Bearer $ARKVORY_KEY" -o Setup-copy.exe \
  http://127.0.0.1:8080/api/v1/repositories/releases/raw/builds/game/1.0/Setup.exe

La subida devuelve un JSON como este:

json
{
  "path": "builds/game/1.0/Setup.exe",
  "revision": 1,
  "created": true,
  "artifact": { "id": "…", "size": "1048576", "sha256": "…" }
}

Si vuelve a subir los mismos bytes, la respuesta es 200 con "created": false y no se crea ninguna versión nueva. Un archivo nuevo recibe el estado 201.

En PowerShell:

powershell
$headers = @{ Authorization = "Bearer $env:ARKVORY_KEY" }
$url = 'http://127.0.0.1:8080/api/v1/repositories/releases/raw/builds/game/1.0/Setup.exe'
Invoke-WebRequest -Method Put -InFile .\Setup.exe -Headers $headers -Uri $url
Invoke-WebRequest -Headers $headers -Uri $url -OutFile .\Setup-copy.exe

Una solicitud PUT debe terminar en 30 minutos. Para archivos muy grandes o redes lentas, use el cliente de línea de comandos: sube en partes y continúa tras un fallo. Consulte Archivos raw.

Paso 6. Usar el cliente de línea de comandos ​

Instale arkvoryctl en su propio equipo: Arkvory-CLI-Setup-x64.exe en Windows, Arkvory-CLI-amd64.deb o Arkvory-CLI-x86_64.rpm en Linux. En una máquina de CI con Node.js 24, también sirve arkvoryctl.mjs.

bash
arkvoryctl profile add local --server http://127.0.0.1:8080 --token-file ~/.arkvory/key
arkvoryctl doctor
arkvoryctl put ./Setup.exe builds/game/1.0/Setup.exe
arkvoryctl get builds/game/1.0/Setup.exe ./Setup-copy.exe

El perfil usa el repositorio releases, salvo que agregue --repository. Si una transferencia se interrumpe, ejecute de nuevo el mismo comando: continúa desde donde se detuvo y comprueba el SHA-256 al final. El cliente acepta HTTP sin cifrar solo para el equipo local; para un servidor remoto, use HTTPS. Consulte Cliente de línea de comandos.

Siguientes pasos ​

Arkvory · ProAnimaStudio