OpenSync

VPS / Ubuntu

Instalar OpenSync no servidor

O daemon OpenSync (binário Rust único) sincroniza qualquer pasta do servidor com um space na cloud, controlado por systemd do utilizador. Substitui o legado opensync-ubuntu (Node.js) com upgrade automático.

Requisitos

  • Ubuntu 22.04+ (ou Debian 12+) — arquitetura amd64.
  • Acesso sudo (apenas durante a instalação do .deb).
  • Conta OpenSync com pelo menos 1 space.
  • Token pessoal (usk_…) — gerado em Definições → Tokens de acesso.

1. Instalação numa linha

Cola no terminal do servidor. O script descarrega o pacote, valida SHA256, instala via dpkg, depois corre opensync init (assistente interativo).

bash
curl -fsSL https://opensync.space/install/ubuntu-core | bash

Para inspecionar o instalador antes de executar, abre o URL no browser ou corre só curl -fsSL ….

2. O assistente vai pedir

  1. URL da API (https://api.opensync.space/api por defeito).
  2. O teu token usk_….
  3. O space a sincronizar (lista os teus, ou cria um novo).
  4. A pasta local a sincronizar.
  5. Geração automática do sync token + ativação do serviço systemd.

3. Gerir o serviço

bash
# Estado do sync e ficheiros monitorizados
opensync status

# Logs em tempo real
journalctl --user -u opensync -f

# Parar / reiniciar / arrancar
systemctl --user stop opensync
systemctl --user restart opensync
systemctl --user start opensync

# Atualizar para nova versão
opensync update

# Desinstalar
opensync uninstall

4. Comandos úteis do CLI

bash
opensync version            # versão instalada
opensync list-space         # lista spaces da tua conta
opensync list-sync          # ficheiros sincronizados
opensync set-sync-dir <dir> # mudar a pasta sincronizada

5. Ficheiros de configuração

  • ~/.config/opensync/config.json — space ID, pasta local, URL da API.
  • ~/.config/opensync/space.token — token de sincronização (chmod 600).
  • ~/.local/share/opensync/{spaceId}.sqlite — estado local dos ficheiros.

Migração do opensync-ubuntu (Node.js)

O instalador detecta a instalação antiga, desativa o serviço Node.js, e substitui pelo novo binário Rust. Os teus ficheiros e configuração são preservados — só precisas de correr opensync init novamente para mover a config para o novo formato.