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.
• Используйте один и тот же HTTPS-домен во всей конфигурации NGINX и Linkwarden.
• BASE_URL особенно полезно, если вы используете почтовые функции: сброс пароля или письма подтверждения.
• Измените конфигурацию Linkwarden по своему усмотрению.