Руководство по установке
PortDock работает на любом Linux-сервере под вашим контролем — VPS, машине в дата-центре или виртуальной машине on-premises — и в Kubernetes.
Требования
- Linux-сервер — рекомендуются Ubuntu или Debian — с доступом root
- Свободные порты 80 и 443 для HTTPS-прокси
- Достаточно памяти для ваших приложений и баз данных (SQL Server нужно около 2 ГБ)
- Docker — установщик добавит его, если его нет
- Для Kubernetes одной командой: новый сервер и DNS-запись (A) вашего домена, указывающая на него
01
Вариант 1 — установщик
Устанавливает Docker, если его нет, и запускает PortDock. Укажите домен, направленный на сервер, чтобы получить HTTPS для панели.
$ git clone https://github.com/gavrilencu/PortDock.git portdock && cd portdock$ sudo bash install.sh # панель на http://<ip-сервера>:8000$ sudo bash install.sh https://portdock.example.com # или с доменомЕсли порт 8000 занят, установщик выберет следующий свободный и выведет адрес (или задайте PORTDOCK_PORT=9000).
02
Вариант 2 — Docker-образ
Если Docker уже установлен.
$ docker run -d --name portdock --restart unless-stopped \ -p 8000:8000 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /data/portdock:/data/portdock \ -e PORTDOCK_PUBLIC_URL=http://<ip-сервера>:8000 \ ghcr.io/gavrilencu/portdock:latestМонтируйте каталог данных по тому же пути, что и на хосте (/data/portdock): сборки и бэкапы монтируются во вспомогательные контейнеры по абсолютному пути.
03
Вариант 3 — Kubernetes на новом сервере, всё сразу
Спрашивает домен панели, затем устанавливает k3s, cert-manager с Let's Encrypt, Docker для сборок и приватный реестр и запускает PortDock на https://ваш-домен с готовыми серверами test и prod.
$ curl -fsSL https://github.com/gavrilencu/PortDock/releases/latest/download/install-kubernetes.sh | sudo bashВ конце выводит ссылку с токеном настройки: откройте её и создайте аккаунт владельца — никто другой не сможет занять панель раньше вас. Дальнейшие обновления выполняются из интерфейса; повторный запуск установщика восстанавливает настройку и сохраняет пароли и данные.
04
Вариант 4 — существующий кластер Kubernetes
PortDock работает в кластере и деплоит в него со своим сервисным аккаунтом.
$ kubectl apply -f https://raw.githubusercontent.com/gavrilencu/PortDock/main/deploy/kubernetes/portdock.yaml$ kubectl -n portdock rollout status statefulset/portdock$ kubectl -n portdock port-forward svc/portdock 8000:8000 # затем откройте http://localhost:8000Чтобы деплоить в кластер из PortDock на Docker-сервере, запустите connect.sh там, где kubectl видит кластер, и вставьте выведенный kubeconfig в Серверы → Подключить сервер → Кластер Kubernetes.
Дальше
- 01
Создайте аккаунт владельца
Откройте панель: первый аккаунт становится владельцем организации.
- 02
Запустите прокси
Серверы → localhost → Запустить настройку устанавливает сеть и прокси Traefik (в Kubernetes это делает ingress-контроллер кластера).
- 03
Подключите код
Настройки → Источники Git: подключите GitHub или Azure DevOps либо используйте любой Git-URL.
- 04
Разверните
Новый ресурс → Git-репозиторий, Docker-образ, Compose, база данных или сервис.
Подключение удалённых серверов
- 1.Серверы → Подключить сервер, затем создайте SSH-ключ.
- 2.Добавьте публичный ключ в ~/.ssh/authorized_keys на сервере (рекомендуется пользователь root).
- 3.Нажмите «Запустить настройку»: будут установлены Docker, сеть portdock и прокси Traefik.
- 4.По желанию: задайте wildcard-домен (*.apps.example.com → IP сервера) для автоматических доменов и превью.
Конфигурация
Переменные окружения контейнера PortDock.
| Переменная | По умолчанию | Описание |
|---|---|---|
| PORTDOCK_ADDR | :8000 | HTTP-адрес для прослушивания |
| PORTDOCK_PORT | 8000 | Порт хоста для install.sh и docker-compose.yml |
| PORTDOCK_DATA_DIR | /data/portdock | База данных, ключ шифрования, сборки и бэкапы |
| PORTDOCK_PUBLIC_URL | http://localhost:8000 | Внешний URL для вебхуков; https:// включает защищённые cookie |
| PORTDOCK_SECRET_KEY | создаётся | AES-ключ для секретов — сохраните его резервную копию |
| PORTDOCK_MAX_BUILDS | 4 | Параллельные деплои |
| PORTDOCK_NETWORK | portdock | Docker-сеть, общая с Traefik |
| PORTDOCK_OPENROUTER_URL | https://openrouter.ai/api/v1 | API для ИИ-ассистента |
| PORTDOCK_TRUSTED_PROXIES | частные сети | Прокси, чьему X-Forwarded-For доверяют для адресов клиентов |
| PORTDOCK_SETUP_TOKEN | – | Нужен для создания аккаунта владельца; задаётся установщиком Kubernetes |
| PORTDOCK_KUBE_SERVERS | – | В кластере: серверы, создаваемые вместе с аккаунтом владельца (пары имя=пространство) |
Обновления
PortDock проверяет наличие нового релиза при каждом открытии и показывает «Доступно обновление» на боковой панели. Один клик — и PortDock проверяет подпись нового образа, делает резервную копию базы и ключа, пересоздаёт себя с новой версией и автоматически откатывается, если она не запускается. Приложения продолжают работать; можно включить автоматические ночные обновления. Так же и в Kubernetes: задание текущей версии переводит PortDock на новую и возвращает предыдущую, если новая не запускается.
Восстановление из командной строки
Потеряли доступ? Сбросьте пароль или отключите двухфакторную аутентификацию прямо на сервере.
$ docker exec portdock portdock -reset-password admin@example.com$ docker exec portdock portdock -disable-2fa user@example.com$ # в Kubernetes$ kubectl -n portdock exec statefulset/portdock -- portdock -reset-password admin@example.comРазработка
Бэкенд на Go и фронтенд на React; мы рады вашему участию.
$ make dev-api # бэкенд на :8000$ make dev-ui # Vite на :5173$ make test # go vet, go test и проверка TypeScript$ make build # bin/portdock со встроенным интерфейсом