1. Введение в связывание

1.1 Введение в связывание

linking — это менеджер закладок, который вы можете разместить самостоятельно. Он спроектирован так, чтобы быть минимальным, быстрым и простым в использовании с настройкой Docker.

1.2 функция связывания

• Чистый пользовательский интерфейс оптимизирует читаемость
• Организуйте закладки с помощью тегов
• Добавляйте комментарии с помощью Markdown
• прочитать позже
• Делитесь закладками с другими пользователями
• Пакетное редактирование
• Автоматически отображать заголовки, описания и значки для сайтов, добавленных в закладки.
• Автоматически создавайте снимки веб-сайтов с закладками в Internet Archive Wayback Machine.
• Импорт и экспорт закладок в формате Netscape HTML.
• Расширения и букмарклеты для Firefox и Chrome
• Светлые и темные темы
• REST API для разработки сторонних приложений
• Панель администратора для самообслуживания пользователей и доступа к необработанным данным
• Простая настройка с использованием баз данных Docker и SQLite, а также дополнительные сценарии использования PostgreSQL1.3.
• Управление личными закладками: Linkding может помочь отдельным пользователям управлять своими собственными закладками, позволяя пользователям получать доступ к сохраненным веб-ссылкам в любое время и в любом месте.
• Совместная работа в команде. Связывание можно использовать как инструмент для совместного использования и совместной работы в команде. Члены команды могут делиться своими собственными закладками, классифицировать и помечать их между закладками, чтобы облегчить обмен знаниями и сотрудничество внутри команды.
• Управление знаниями: связывание можно использовать для управления различными типами ссылок, не только веб-ссылками, но также ссылками на файлы, ссылки на документы и т. д., что позволяет легко архивировать и систематизировать различные знания.
• Управление частными закладками: поскольку Linking может размещаться на самом сервере, он может обеспечить безопасность и конфиденциальность закладок, что подходит для пользователей с более высокими требованиями к конфиденциальности.

2. Знакомство с местной средой

2.1 Планирование местной окружающей среды

Эта практика представляет собой личную тестовую среду, а версия операционной системы — centos7.6.

2.2 Введение в эту практику

1. Среда развертывания для этой практики — это персональная тестовая среда, будьте осторожны в производственной среде;

2. Разверните менеджер связывающих закладок в среде Docker.

3. Проверка местной окружающей среды

3.1 Проверка статуса службы Docker

Проверьте, нормально ли работает служба Docker, и убедитесь, что Docker работает нормально.

[root@jeven ~]# systemctl status docker
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
   Active: active (running) since Fri 2024-03-01 00:18:43 CST; 52s ago
     Docs: https://docs.docker.com
 Main PID: 11826 (dockerd)
    Tasks: 28
   Memory: 155.4M
   CGroup: /system.slice/docker.service
           ├─11826 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

3.2 Проверьте версию Docker

Проверьте версию Докера

[root@jeven ~]# docker -v
Docker version 20.10.17, build 100c701

3.3 Проверьте версию Docker Compose

Проверьте версию Docker Compose, чтобы убедиться, что она 2.0 или выше.

[root@jeven ~]# docker compose version
Docker Compose version v2.6.0

4. Загрузите связанное изображение.

Извлеките изображение диспетчера связывающих закладок из Docker Hub.

docker pull nanawel/our-shopping-list

Вставьте сюда описание изображения

5. Развертывание связывающего приложения

5.1 Создайте каталог развертывания

Создайте новый каталог/data/linking/data.

mkdir -p /data/linkding/data  && cd /data/linkding/

5.2. Отредактируйте файл docker-compose.yaml.

Используйте docker-cli для развертывания, команда выглядит следующим образом:

docker run --name linkding -p 9090:9090 -v /data/linkding/data:/etc/linkding/data -d sissbruecker/linkding:latest

В этом практическом развертывании используется метод docker compose и отредактированный файл docker-compose.yaml.

version: '3'

services:
  linkding:
    container_name: "${LD_CONTAINER_NAME:-linkding}"
    image: sissbruecker/linkding:latest
    ports:
      - "${LD_HOST_PORT:-9090}:9090"
    volumes:
      - "/data/linkding/data:/etc/linkding/data"
    env_file:
      - .env
    restart: unless-stopped

5.3 Редактировать файл .env

В каталоге развертывания отредактируйте файл .env со следующим содержимым:

# Docker container name
LD_CONTAINER_NAME=linkding
# Port on the host system that the application should be published on
LD_HOST_PORT=9090
# Directory on the host system that should be mounted as data dir into the Docker container
LD_HOST_DATA_DIR=./data

# Can be used to run linkding under a context path, for example: linkding/
# Must end with a slash `/`
LD_CONTEXT_PATH=
# Username of the initial superuser to create, leave empty to not create one
LD_SUPERUSER_NAME=
# Password for the initial superuser, leave empty to disable credentials authentication and rely on proxy authentication instead
LD_SUPERUSER_PASSWORD=
# Option to disable background tasks
LD_DISABLE_BACKGROUND_TASKS=False
# Option to disable URL validation for bookmarks completely
LD_DISABLE_URL_VALIDATION=False
# Enables support for authentication proxies such as Authelia
LD_ENABLE_AUTH_PROXY=False
# Name of the request header that the auth proxy passes to the application to identify the user
# See docs/Options.md for more details
LD_AUTH_PROXY_USERNAME_HEADER=
# The URL that linkding should redirect to after a logout, when using an auth proxy
# See docs/Options.md for more details
LD_AUTH_PROXY_LOGOUT_URL=
# List of trusted origins from which to accept POST requests
# See docs/Options.md for more details
LD_CSRF_TRUSTED_ORIGINS=

# Database settings
# These are currently only required for configuring PostreSQL.
# By default, linkding uses SQLite for which you don't need to configure anything.

# Database engine, can be sqlite (default) or postgres
LD_DB_ENGINE=
# Database name (default: linkding)
LD_DB_DATABASE=
# Username to connect to the database server  (default: linkding)
LD_DB_USER=
# Password to connect to the database server
LD_DB_PASSWORD=
# The hostname where the database is hosted (default: localhost)
LD_DB_HOST=
# Port use to connect to the database server
# Should use the default port if not set
LD_DB_PORT=
# Any additional options to pass to the database (default: {})
LD_DB_OPTIONS=

5.4 Создание связывающего контейнера

осуществлятьdocker compose up -dЗаказ,Создать связывающий контейнер。

[root@jeven linkding]# docker compose up -d
[+] Running 2/2
 ⠿ Network linkding_default  Created                                                                                                            0.1s
 ⠿ Container linkding        Started                                                                                                            0.8s

5.5. Просмотр статуса связывающего контейнера

Проверьте состояние связывающего контейнера, чтобы убедиться, что связывающий контейнер запускается нормально.

[root@jeven linkding]# docker compose ps
NAME                COMMAND             SERVICE             STATUS              PORTS
linkding            "./bootstrap.sh"    linkding            running (healthy)   0.0.0.0:9090->9090/tcp, :::9090->9090/tcp

5.6 Настройка учетной записи доступа

• Если вы используете docker-cli для развертывания, используйте следующие команды, чтобы установить учетную запись и пароль для входа.

docker exec -it linkding python manage.py createsuperuser --username=joe --email=joe@example.com

Используя docker Compose, используйте следующие команды, чтобы установить учетную запись и пароль для входа.

docker compose exec linkding python manage.py createsuperuser --username=admin --email=joe@example.com

Вставьте сюда описание изображения

6. Посетите домашнюю страницу со ссылками.

6.1 Войдите на страницу входа по ссылке

Адрес доступа: http://192.168.3.166:9090, замените IP на IP-адрес вашего собственного сервера, войдите на страницу входа в наш список покупок и настройте регистрационную учетную запись и пароль. Если к нему нет доступа, проверьте, настроен ли брандмауэр сервера, разрешен ли порт группы безопасности облачного сервера и т. д.

Вставьте сюда описание изображения

6.2 Войдите на главную страницу ссылки.

Введите учетную запись и пароль, которые вы установили для входа на главную страницу ссылки.

Вставьте сюда описание изображения

7. Базовое использование ссылок

7.1 Добавление закладок

Нажмите кнопку «Добавить закладку», чтобы создать новую закладку.

Вставьте сюда описание изображения

Заполните URL-адрес закладки, заголовок и другую информацию и сохраните ее.

Вставьте сюда описание изображения

7.2 Открытие закладок

В списке закладок на главной странице щелкните закладку, чтобы открыть ее содержимое.

Вставьте сюда описание изображения

Вставьте сюда описание изображения

8. Резюме

Linkding — это автономный менеджер закладок, предназначенный для обеспечения минимальной, быстрой и простой в использовании настройки Docker. Linkding можно быстро развернуть локально, он имеет красивый и простой интерфейс, что позволяет легко начать работу даже новичкам. Вы можете получить хороший опыт использования Linkding, поскольку он обладает мощными функциями. Если вам нужен инструмент для создания закладок, попробуйте Linkding.

Я участвую в последнем конкурсе эссе для специального учебного лагеря Tencent Technology Creation 2024. Приходите и разделите со мной приз!