Load default configuration

在VPS上安装蒲公英的详细指南

蒲公英（Puffin DNS）是一个功能强大的开源DNS服务，支持多租户、负载均衡、自动记录等特性，如果你的VPS需要一个高性能、易用的DNS服务，那么安装蒲公英可能是你的好选择,以下是详细的安装和配置指南。

---

安装前的准备

在安装蒲公英之前,你需要确保你的VPS环境满足以下要求：

1. 操作系统版本

   • 如果你使用的是Debian/Ubuntu系列，建议使用版本2.0或更高。
   • 如果是其他操作系统（如RHEL/CentOS），建议使用版本3.0或更高。

2. 安装必要的软件

   • 如果你使用的是Debian/Ubuntu，确保已经安装了apt工具。
   • 如果是其他操作系统，确保已经安装了dnsmasq服务。

3. 启用防火墙和系统服务

   • 在etc/firewall.d/active文件中，确保firewall-cmd服务是开启的。
   • 在etc/dnsmasq.conf中，确保dnsmasq服务是开启的。

4. 备份数据

   在安装新软件之前，建议备份重要数据,以防万一。

---

安装蒲公英

下载蒲公英

从官方网站或可信源下载蒲公英的源码或二进制版本，如果是源码版本，建议使用git克隆仓库：

git clone https://github.com/puffin-project/puffin-dns.git
cd puffin-dns

如果是二进制版本,可以直接下载安装文件。

解压文件

将下载的蒲公英文件解压到/var/www/目录下：

sudo apt-get install -y ./puffin-dns-2.x.x.x-amd64

（根据你的系统版本调整路径。）

安装蒲公英

运行安装脚本：

sudo ./install

设置环境变量

在安装完成后,设置必要的环境变量：

export LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libcgroup.so.1
export LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libcgroup.so.1.0

配置蒲公英

蒲公英的配置文件位于/var/www/config/目录下,以下是常见的配置项：

• 配置DNS服务器
  在config-nameserver文件中,添加你的DNS服务器地址：

  nameserver 127.0.0.1
  nameserver 8.8.8.8

• 启用负载均衡
  在config-namespace文件中,设置负载均衡选项：

  nsdi enabled
  nsdi max-pool 10
  nsdi min-pool 2

• 启用SSO（Single Sign-On）
  在config-ss文件中,启用SSO：

  sso true
  sso disable-gui
  sso disable-browser-logout

修改etc/dnsmasq服务

将蒲公英配置为dnsmasq服务：

sudo nano /etc/dnsmasq.conf

# Load user configuration
include=/etc/dnsmasq.d/user.###
# Service configuration
[global]
  log-file=/var/log/dnsmasq.log
  log-level=debug
  log-format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
[dnsmasq]
  server-list=nameserver1nameserver2
  max-pool=10
  min-pool=2
  auto-reload=true
  disable-gui=true
  disable-browser-logout=true
# SSO configuration
[ssd]
  sso=true
  disable-gui=true
  disable-browser-logout=true
# Load plugins
include=/etc/dnsmasq.d/plugin.###
# Start service
start=dnsmasq

保存并退出编辑器。

重启dnsmasq服务

sudo systemctl restart dnsmasq

---

配置蒲公英

你已经安装了蒲公英,接下来需要配置它以满足你的需求。

配置DNS服务器

在config-nameserver文件中,添加你的DNS服务器地址：

nameserver 127.0.0.1
nameserver 8.8.8.8

启用负载均衡

在config-namespace文件中,启用负载均衡：

nsdi enabled
nsdi max-pool=10
nsdi min-pool=2

启用SSO

在config-ss文件中,启用SSO：

sso=true
sso disable-gui=true
sso disable-browser-logout=true

修改etc/dnsmasq.conf

将蒲公英配置为dnsmasq服务：

sudo nano /etc/dnsmasq.conf

# Load user configuration
include=/etc/dnsmasq.d/user.###
# Service configuration
[global]
  log-file=/var/log/dnsmasq.log
  log-level=debug
  log-format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
[dnsmasq]
  server-list=nameserver1nameserver2
  max-pool=10
  min-pool=2
  auto-reload=true
  disable-gui=true
  disable-browser-logout=true
# SSO configuration
[ssd]
  sso=true
  disable-gui=true
  disable-browser-logout=true
# Load plugins
include=/etc/dnsmasq.d/plugin.###
# Start service
start=dnsmasq

保存并退出编辑器。

重启dnsmasq服务

sudo systemctl restart dnsmasq

---

安全设置

为了确保蒲公英的安全,建议进行以下配置：

1. 启用防火墙

   在etc/firewall.d/active文件中，启用firewall-cmd服务：

   sudo systemctl enable firewall-cmd

2. 配置安全组

   在firewall-cmd的配置文件中,添加安全组规则：

   [firewall]
     interface=eth0
     state=accept
     protocol[tcp]:--1024,--49152/50000/50900/52000/52200
     protocol[udp]:--1024,--16383
     state=accept

3. 启用SSO

   在etc/dnsmasq.conf中,启用SSO：

   [ssd]
     sso=true
     disable-gui=true
     disable-browser-logout=true

4. 设置密码

   修改etc/passwd文件,为蒲公英设置一个安全的密码：

   sudo nano /etc/passwd

   puffin-dns root root root root /etc/passwd

5. 限制root权限

   在etc/limits.conf文件中,限制root用户的权限：

   [domain root]
     filesw:yes
     fileo:yes
     dev:yes
     net:yes
     cap:yes

---

常见问题

1. 配置失败

   如果安装过程中出现错误,检查以下内容：

   • 系统版本是否符合要求
   • 环境变量是否正确设置
   • 配置文件路径是否正确

2. DNS无法访问

   • DNS服务器地址是否正确
   • 网络连接是否正常
   • 网络路由是否正确

3. 负载均衡失败

   • 负载均衡配置是否正确
   • 服务是否正常运行
   • 服务日志是否显示负载均衡信息

4. 安全问题

   • 防火墙规则是否正确
   • 安全组配置是否正确
   • 服务是否启用SSO

---

安装蒲公英需要一定的配置和配置，但它的功能非常强大，适合企业级和个人博客使用，通过以上步骤，你可以轻松地在你的VPS上安装蒲公英，并根据需要进行配置和调整,希望这篇文章能帮助你顺利完成安装过程！