Proxmox 컨테이너에 Outline Wiki 설치

Source: Dev.to

1. Proxmox 커뮤니티를 통한 설치

Proxmox 커뮤니티 페이지에 접속하여 How to install 섹션의 코드를 복사하세요:

https://community-scripts.github.io/ProxmoxVE/scripts?id=outline

Proxmox 터미널에서 스크립트를 실행하세요 (2 CPU 권장).

참고:
Verbose는 선택 사항입니다. 활성화(YES)하면 쉘을 통해 스크립트가 수행하는 모든 작업을 확인할 수 있습니다.

2. Nginx와 mkcert를 이용한 HTTPS 인증서 설치

Nginx

mkdir -p /etc/outline-ssl
apt update
apt install -y nginx
systemctl status nginx

mkcert

# Baixar a última versão
curl -s https://api.github.com/repos/FiloSottile/mkcert/releases/latest \
  | grep "browser_download_url.*linux-amd64" \
  | cut -d : -f 2,3 \
  | tr -d \" \
  | wget -i -

# Tornar executável e mover para o PATH
chmod +x mkcert-v*-linux-amd64
sudo mv mkcert-v*-linux-amd64 /usr/local/bin/mkcert

# Instalar a CA local
mkcert -install

# Gerar certificado para o IP da máquina
mkdir -p /opt/outline/mkcert
cd /opt/outline/mkcert
mkcert 192.168.254.95

이 명령은 예를 들어 다음과 같은 두 개의 파일을 생성합니다:

• 192.168.254.95.pem
• 192.168.254.95-key.pem

Nginx 설정

# /etc/nginx/sites-available/outline.conf
server {
    listen 443 ssl;
    server_name 192.168.254.95;

    ssl_certificate     /opt/outline/mkcert/192.168.254.95.pem;
    ssl_certificate_key /opt/outline/mkcert/192.168.254.95-key.pem;
    http2 on;

    location / {
        proxy_pass http://127.0.0.1:3000;   # porta interna do Outline
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

사이트를 활성화합니다:

ln -s /etc/nginx/sites-available/outline.conf /etc/nginx/sites-enabled/
systemctl reload nginx

3. HTTPS WebSocket 설정

주의:
서비스를 재시작하면 502 Bad Gateway 페이지가 나타날 수 있습니다. 몇 분 정도 기다리면 페이지가 정상적으로 로드됩니다.

환경 파일을 편집합니다:

nano /opt/outline/.env

아래 줄을 수정합니다 (올바른 IP로 교체하십시오):

URL=https://192.168.250.95
COLLABORATION_URL=wss://192.168.250.95
FORCE_HTTPS=false

Outline 서비스를 재시작하고 HTTPS를 통해 접근을 확인합니다 (이제 포트 3000을 사용할 필요가 없습니다):

https://

4. Slack API 연결 설정

1. https://slack.com/intl/pt-br/에 접속하고 COMEÇAR 버튼을 클릭합니다.
2. 이메일을 입력하고 인증 코드를 받은 뒤 약관에 동의합니다.
3. Google에서 api slack을 검색하거나 https://api.slack.com/apps 로 바로 이동합니다.
4. Create an app → From scratch를 클릭하고 앱 이름을 정한 뒤 워크스페이스를 선택합니다. Create App을 클릭합니다.

필요한 데이터

• App ID → SLACK_APP_ID (이 값을 복사합니다).

Slack API 페이지에서 OAuth & Permissions으로 이동하여 다음 Redirect URL을 추가합니다 (“을 자신의 IP로 교체):

https:///auth/slack.callback/

Outline 서비스를 재시작하고 로그인 화면에서 만든 Slack 계정으로 연결합니다.

5. SMTP를 통한 이메일 전송 설정

Edite novamente o arquivo de ambiente:

nano /opt/outline/.env

Localize a seção SMTP e preencha com as informações da sua conta de e‑mail (exemplo Gmail):

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=seuemail@gmail.com
SMTP_PASS=suasenha
SMTP_FROM=seuemail@gmail.com

Salve o arquivo e reinicie os serviços Outline.

Dentro do Outline, vá em Configurações → Authentication e ative o envio de SMTP. (Recomenda‑se desativar Passkeys temporariamente.)

Envie convites de acesso por e‑mail ou faça logout e verifique se a página inicial exibe a opção “Continuar com E‑mail”.

Pronto! Seu Outline Wiki está configurado e pronto para uso. Boa construção da documentação.