668 字
3 分钟

Dokploy部署和使用教程


Dokploy 使用指南#

简介#

Dokploy 是一个开源的一站式部署平台,是 Vercel 和 Netlify 的替代方案。它支持各种封装好的容器部署,并且提供自动化功能,比如自动部署、自动更新、自动备份等,非常适合个人开发者或者小型团队使用。

dokploy
/
dokploy
Waiting for api.github.com...
00K
0K
0K
Waiting...

功能概览#

  • 应用程序部署:支持 Node.js、PHP、Python、Go、Ruby 等多种语言。
  • 数据库管理:支持 MySQL、PostgreSQL、MongoDB、MariaDB、Redis 等数据库。
  • Docker 管理:轻松部署和管理 Docker 容器。
  • Traefik 集成:自动与 Traefik 集成,实现路由和负载均衡。
  • 实时监控:监控 CPU、内存、存储和网络使用情况。
  • 数据库备份:支持多种存储目标,实现自动备份。

部署指南#

服务器要求#

  • 内存:至少 2GB
  • 磁盘:至少 30GB

这是为了保证 Docker 在构建和运行容器时不会消耗过多资源,防止系统崩溃。

Docker 配置#

确保 Docker 已安装,并修改 /etc/docker/daemon.json,以优化日志和启用实验功能:

{
"log-driver": "json-file",
"log-opts": {
"max-size": "20m",
"max-file": "3"
},
"experimental": true,
"data-root": "/root/docker_data"
}

安装 Dokploy#

官方提供一键安装脚本:

Terminal window
curl -sSL https://dokploy.com/install.sh | sh

完成后,访问 http://your-vps-ip:3000 进行初始设置。


初始设置#

管理员账户#

在初始页面创建管理员账户,这是 Dokploy 的主账号。

首页 og 图片

安全设置#

建议使用 ufw 限制访问 3000 端口,防止外部直接访问:

Terminal window
ufw deny 3000
ufw reload

面板基础设置#

  • 开启 SSL
  • 开启 Docker 自动清理,避免硬盘空间占满

image-20251117151823904


Git 集成(CI/CD)#

配置 Git 账户,实现自动化部署:

  1. 选择 Git 平台(GitHub / GitLab / Bitbucket 等)
  2. 授权 Dokploy 访问仓库
  3. 选择需要部署的仓库或全部仓库

Git账户选择 仓库选择


项目部署#

通过 GitHub 仓库部署#

  1. 创建项目并选择 Git 仓库、分支
  2. 选择 build 方式(一般默认即可)
  3. 根据需求配置其他参数
  4. Domain 页面 设置域名,Traefik 会自动进行反向代理

项目创建 仓库配置

完成后,你的项目即可访问配置好的域名。

模板部署#

官方提供各种模板:https://templates.dokploy.com/

  1. 选择合适模板
  2. 检查 docker-compose.yml 或其他配置
  3. 点击 Deploy 完成部署

模板选择 image-20251117151711828

域名设置同样通过 Traefik 自动反代,无需额外操作,只需解析到服务器即可。


总结#

Dokploy 通过简单的一键安装和图形化界面,极大降低了容器部署门槛,同时集成了 Git CI/CD、数据库管理、自动备份、监控等功能,是个人开发者和小型团队部署应用的理想选择。


Dokploy部署和使用教程
https://catcat.blog/dokploy-deploy.html
作者
猫猫博客
发布于
2025-11-17
许可协议
CC BY-NC-SA 4.0