# Dokku

## 产品介绍

Dokku 是面向单机服务器的开源 PaaS，可通过 Git 推送、Dockerfile、Buildpack 和插件构建、部署与管理应用，并由内置 Nginx/OpenResty 提供路由。

## 主要功能

- 通过 Git SSH 推送代码并自动构建、发布应用。
- 使用 Dockerfile、Herokuish、Nixpacks、Railpack 等构建器。
- 管理应用配置、域名、进程、存储、证书和定时任务。
- 通过插件扩展 PostgreSQL、Redis 等服务。

## 访问说明

- Dokku 没有管理 WebUI，主要通过 SSH、Git 和 `dokku` 命令管理。
- HTTP/HTTPS 端口用于访问 Dokku 部署的应用，SSH 端口用于 Git 推送和管理。
- `DOKKU_HOSTNAME` 应设置为解析到服务器的域名；测试值 `dokku.me` 仅适合临时体验。
- 添加 SSH 公钥需要进入容器执行 `dokku ssh-keys:add`，具体命令见上游用户管理文档。

## 数据持久化

- `APP_DATA_DIR` 必须是宿主机绝对路径，默认 `/var/lib/dokku`。
- 该目录挂载到 `/mnt/dokku`，保存 Git 仓库、插件、配置、服务数据和 SSH 状态。
- 升级前应备份整个目录，并同时备份 Dokku 创建的应用容器、卷和数据库插件数据。

## 高风险权限说明

Dokku 的核心功能必须挂载宿主机 `/var/run/docker.sock`。这相当于授予容器宿主机 root 级控制能力：Dokku 及其插件可以创建、删除、检查或挂载任意 Docker 容器、镜像、网络和卷，也可能影响 1Panel 管理的其他应用。

仅在专用或充分受信任的服务器上安装。不要向不受信任用户开放 Dokku SSH 权限，不要安装来源不明的插件。卸载 Dokku 应用不会自动删除它创建的子容器、镜像、网络和卷，需要管理员按上游流程审计后手工清理。

## 端口与网络风险

- Dokku 部署的应用可能创建额外端口和 Docker 网络，这些资源不会自动出现在当前应用包的 Compose 文件中。
- 内置路由会占用应用 HTTP/HTTPS 端口。使用 1Panel 网站反向代理时，应规划好域名、端口和 TLS 终止位置，避免与现有服务冲突。
- 官方容器使用 Docker 默认 bridge 网络，本适配保留该行为以保证 Dokku 的应用路由和容器管理逻辑。

## Introduction

Dokku is a Docker-powered single-server PaaS for building, deploying, and managing applications through Git pushes, buildpacks, and plugins.

## Features

- Deploy applications through Git SSH pushes.
- Build with Dockerfiles and multiple buildpack-style builders.
- Manage domains, processes, storage, certificates, and scheduled jobs.
- Extend the platform with database and service plugins.

## Links

- Website: https://dokku.com
- Project: https://github.com/dokku/dokku
- Docker installation: https://dokku.com/docs/getting-started/install/docker/
- Image: https://hub.docker.com/r/dokku/dokku