Éterpad

Acesse o Etherpad

• Interface do usuário: https://<SERVER_IP>
• Interface administrativa: https://<SERVER_IP>/admin
• Credenciais de administrador: nome de usuário admin, senha armazenada em .env as ADMIN_PASSWORD

Adicionar usuários por meio das configurações de administrador

1. Visite: https://<SERVER_IP>/admin

2. Vá para Configurações.

3. Um arquivo de configuração JSON será exibido.

4. Localize o users seção:

  "users": {
    "admin": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "${ADMIN_PASSWORD:null}",
      "is_admin": true
    },
    "user": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "test",
      "is_admin": false
    }
  },

5. Adicione um novo usuário (siga a sintaxe JSON válida):

  "users": {
    "admin": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "${ADMIN_PASSWORD:null}",
      "is_admin": true
    },
    "user": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "test",
      "is_admin": false
    },
    "newuser": {
      "password": "strongpassword",
      "is_admin": false
    }
  },

6. Clique em Salvar configurações.

7. Clique em Reiniciar Etherpad.

Ficheiros e diretórios importantes

• Instalação do aplicativo: /root/etherpad
• Ficheiro Docker Compose: /root/etherpad/docker-compose.yml
• Variáveis ​​de ambiente: /root/etherpad/.env
• Dados do banco de dados PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Dados de tempo de execução do Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Diretório de plug-ins: /var/lib/docker/volumes/etherpad_plugins/_data
• Configuração Nginx: /etc/nginx/sites-available/etherpad
• Certificados SSL: /etc/nginx/ssl/

Gestão de serviços

Listar contêineres:

docker ps

Reinicie os contêineres:

docker compose -f /root/etherpad/docker-compose.yml restart

Siga os registros do Etherpad:

docker compose -f /root/etherpad/docker-compose.yml logs -f

Reinicie o Nginx:

systemctl restart nginx

Ativar SSL com um domínio

1. Aponte o seu domínio para o IP do servidor.

2. Edite a configuração do Nginx e substitua ambos server_name <IP>; com o seu domínio (<your-domain>) para ambos os blocos HTTP (porta 80) e HTTPS (porta 443):

vim /etc/nginx/sites-available/etherpad

3. Instalar o Certbot:

apt install -y certbot python3-certbot-nginx

4. Execute o seguinte comando para gerar um certificado Let’s Encrypt válido:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Substitua os caminhos SSL na configuração do Nginx:

vim /etc/apache2/sites-available/etherpad
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Reinicie o Nginx para aplicar as alterações:

systemctl restart nginx

7. Abra o seu browser e visite: https://yourdomain.com

Notas

• O Etherpad é servido por um proxy reverso Nginx para terminação SSL e segurança aprimorada.
• Um certificado autoassinado pode acionar avisos do navegador; isso é esperado, a menos que Let's Encrypt seja usado.
• Alguns navegadores podem exibir erros ou fazer com que o Etherpad funcione incorretamente.
• O Etherpad foi testado e confirmado para funcionar no Firefox, que é recomendado para melhor compatibilidade.