# PgBouncer 编译与安装 > PgBouncer 编译与安装说明 --- LLMS index: [llms.txt](/llms.txt) --- > 原始页面： -------- ## 编译 PgBouncer 的编译依赖以下组件： * [GNU Make] 3.81+ * [Libevent] 2.0+ * [pkg-config] * [OpenSSL] 1.0.1+（TLS 支持） * （可选）[c-ares]，作为 Libevent 内置 evdns 的替代方案 * （可选）LDAP 库 * （可选）PAM 库 [GNU Make]: https://www.gnu.org/software/make/ [Libevent]: http://libevent.org/ [pkg-config]: https://www.freedesktop.org/wiki/Software/pkg-config/ [OpenSSL]: https://www.openssl.org/ [c-ares]: http://c-ares.haxx.se/ 安装依赖后，执行以下命令： $ ./configure --prefix=/usr/local $ make $ make install 如果从 Git 构建或在 Windows 上构建，请参阅下方的单独构建说明。 -------- ## DNS 查询支持 PgBouncer 在每次连接时执行主机名查询，而非仅在配置加载时查询一次。这需要异步 DNS 实现。下表列出了支持的后端及其探测顺序： | 后端 | 并行 | EDNS0 (1) | /etc/hosts | SOA 查询 (2) | 备注 | |------------------------------|-------|-----------|------------|--------------|---------------------------------------| | c-ares | 是 | 是 | 是 | 是 | <=1.10 版本中 IPv6+CNAME 存在缺陷 | | evdns, libevent 2.x | 是 | 否 | 是 | 否 | 不检查 /etc/hosts 更新 | | getaddrinfo_a, glibc 2.9+ | 是 | 是 (3) | 是 | 否 | 非 glibc 环境不可用 | | getaddrinfo, libc | 否 | 是 (3) | 是 | 否 | 需要 pthreads | 1. 若需要一个主机名对应 8 个以上 IP 地址，则需要 EDNS0 支持。 2. SOA 查询用于在区域序列号变更时重新检查主机名。 3. 要启用 EDNS0，请在 `/etc/resolv.conf` 中添加 `options edns0`。 c-ares 是功能最完整的实现，推荐在大多数场景和二进制打包中使用（前提是有足够新的版本可用）。Libevent 内置的 evdns 在列出的限制条件下也适用于许多场景。其他后端目前基本属于遗留选项，不再接受太多测试。 默认情况下，若系统中存在 c-ares，则会优先使用它。可通过 `configure --with-cares` 强制使用，或通过 `--without-cares` 禁用。若不使用 c-ares（未找到或被禁用），则使用 Libevent。指定 `--disable-evdns` 可禁用 Libevent 的 evdns，并回退到基于 libc 的实现。 -------- ## PAM 认证 要启用 PAM 认证，`./configure` 提供了 `--with-pam` 标志（默认值为 no）。编译时启用 PAM 支持后，将新增一个全局认证类型 `pam`，可通过 PAM 对用户进行鉴权。 -------- ## LDAP 认证 要启用 LDAP 认证，`./configure` 提供了 `--with-ldap` 标志（默认值为 no）。编译时启用 LDAP 支持后，将新增一个全局认证类型 `ldap`，可通过 LDAP 对用户进行鉴权。 -------- ## systemd 集成 要启用 systemd 集成，请使用 `configure` 选项 `--with-systemd`。这将允许使用 `Type=notify`（若使用 systemd 253 或更高版本，则可使用 `Type=notify-reload`）以及 socket 激活。示例请参见 `etc/pgbouncer.service` 和 `etc/pgbouncer.socket`。 -------- ## 从 Git 构建 从 Git 构建 PgBouncer 需要在运行 `configure` 之前先生成头文件和配置文件： $ git clone https://github.com/pgbouncer/pgbouncer.git $ cd pgbouncer $ ./autogen.sh $ ./configure $ make $ make install 默认情况下，所有文件将安装在 `/usr/local` 下。可向 `configure` 提供一个或多个命令行选项。运行 `./configure --help` 可列出所有可用选项及用于自定义配置的环境变量。 额外需要的软件包：autoconf、automake、libtool、pandoc -------- ## 测试 如需了解如何运行测试，请参阅 [**测试目录中的 `README.md` 文件**][1]。 [1]: https://github.com/pgbouncer/pgbouncer/blob/master/test/README.md -------- ## 在 Windows 上构建 Windows 上唯一受支持的构建环境是 MinGW。不支持 Cygwin 和 Visual $ANYTHING。 在 MinGW 上构建，按照常规方式执行： $ ./configure $ make 如果从 Unix 交叉编译： $ ./configure --host=i586-mingw32msvc LDAP 构建选项目前不支持 Windows。 -------- ## 在 Windows 上运行 从命令行运行的方式与通常相同，但 `-d`（守护进程化）、`-R`（重启）和 `-u`（切换用户）选项无法使用。 要将 PgBouncer 作为 Windows 服务运行，需要配置 `service_name` 参数以设置服务名称。然后执行： $ pgbouncer -regservice config.ini 要卸载服务： $ pgbouncer -unregservice config.ini 要使用 Windows 事件日志，请在配置文件中设置 `syslog = 1`。但在此之前，需要先注册 `pgbevent.dll`： $ regsvr32 pgbevent.dll 要取消注册，执行： $ regsvr32 /u pgbevent.dll