Linkwarden

접속

1. 열기 http://<SERVER_IP>.
2. 'Sign Up'을 클릭합니다.
3. 첫 번째 계정을 만듭니다.
4. 첫 번째 계정이 서버 관리자가 됩니다. 이유는 NEXT_PUBLIC_ADMIN=1 이 활성화되어 있기 때문입니다.

등록

회원가입은 기본적으로 활성화되어 있습니다.

관리자 계정을 만든 뒤에는 회원가입을 끌 수 있습니다.

끄려면 다음을 편집합니다: /root/linkwarden/.env 다음과 같이 설정합니다:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

그런 다음 구성을 적용합니다:

cd /root/linkwarden
docker compose up -d

중요한 경로

• 설치 경로: /root/linkwarden
• Compose 파일: /root/linkwarden/docker-compose.yml
• 환경 파일: /root/linkwarden/.env
• 앱 데이터: /root/linkwarden/data
• PostgreSQL 데이터: /root/linkwarden/pgdata
• Meilisearch 데이터: /root/linkwarden/meili_data
• Nginx 설정: /etc/nginx/sites-available/linkwarden

Docker 관리

컨테이너를 확인합니다:

cd /root/linkwarden
docker compose ps

로그 보기:

cd /root/linkwarden
docker compose logs -f

Linkwarden 로그 보기:

cd /root/linkwarden
docker compose logs -f linkwarden

Linkwarden 재시작:

cd /root/linkwarden
docker compose restart linkwarden

스택 중지:

cd /root/linkwarden
docker compose down

스택 시작:

cd /root/linkwarden
docker compose up -d

NGINX 관리

NGINX를 확인합니다:

systemctl status nginx

구성을 테스트합니다:

nginx -t

NGINX 재시작:

systemctl restart nginx

NGINX 리로드:

systemctl reload nginx

도메인 및 HTTPS

1. 다음 레코드를 만듭니다: A 앱 호스트 이름에 대해 만들고 서버의 공인 IP 주소로 지정합니다(예: app.example.com).

2. Certbot 설치:

apt update
apt install -y certbot python3-certbot-nginx

3. NGINX 설정을 편집하고 다음을 바꿉니다: server_name _; 을 자신의 도메인으로 바꿉니다(예: server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. 구성을 테스트합니다:

nginx -t

5. NGINX를 다시 로드합니다:

systemctl reload nginx

6. TLS 인증서를 발급합니다:

certbot --nginx -d app.example.com

7. Linkwarden의 환경 변수를 업데이트합니다(.env 파일):

NEXTAUTH_URL=https://app.example.com/api/v1/auth
BASE_URL=https://app.example.com

8. 환경 변수를 변경한 후 Linkwarden을 재시작합니다:

cd /root/linkwarden
docker compose down
docker compose up -d

9. 브라우저를 열고 방문: https://app.example.com

참고

• Linkwarden은 Nginx를 통해 다음 포트에서 공개됩니다 80.
• Linkwarden 애플리케이션 자체는 다음에서만 대기합니다 127.0.0.1:3000.
• PostgreSQL과 Meilisearch는 내부 Docker 서비스이며 호스트에 직접 노출되지 않습니다.
• 도메인을 설정할 때 다음을 반드시 바꾸세요: http:// 을 다음으로: https:// 애플리케이션 URL이 설정된 모든 곳에서. 여기에는 다음이 포함됩니다 NEXTAUTH_URL 와 BASE_URL.
• NGINX와 Linkwarden 구성 전반에서 동일한 HTTPS 도메인을 일관되게 사용하세요.
• BASE_URL 비밀번호 재설정이나 확인 메일 같은 이메일 기능을 사용할 때 특히 유용합니다.
• Linkwarden 구성은 원하는 대로 변경하세요.