讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

PostgreSQL 连接中禁用 SSL 的完整配置指南

陌静君_8443

陌静君_8443

发布时间:2025-12-31 14:48:07

|

495人浏览过

|

来源于php中文网

原创

PostgreSQL 连接中禁用 SSL 的完整配置指南

当使用 sequelize 连接 docker 中的 postgresql 容器时,若未显式禁用 ssl,sequelize 会默认尝试启用 ssl,而官方 postgres:latest 镜像默认不支持 ssl,从而报错 “the server does not support ssl connections”。解决方法是在连接 url 或 sequelize 配置中明确关闭 ssl。

在 Docker Compose 环境中,PostgreSQL 容器(如 postgres:latest)默认以非 SSL 模式运行,不生成或加载 SSL 证书。而 Sequelize(尤其是较新版本)在使用 dialect: 'postgres' 时,会依据环境或底层 pg 驱动策略,自动尝试启用 SSL 连接(例如当检测到 DATABASE_URL 存在、或系统环境含 PGSSLMODE 但未被正确透传时),导致连接失败。

关键点在于:.env.development 中的 DATABASE_URL(如有)或 Sequelize 初始化参数,必须显式声明 SSL 禁用策略——仅在 docker-compose.yml 中设置 PGSSLMODE=disable 对 Node.js 应用完全无效,因为该变量仅作用于 PostgreSQL 容器自身,不会传递给你的 Express 应用。

✅ 推荐解决方案(二选一,推荐方案一):

方案一:通过连接 URL 显式禁用 SSL(最清晰、最可靠)
确保 .env.development 中的 DATABASE_URL 包含 ?sslmode=disable 参数:

# .env.development
DATABASE_URL=postgres://postgres:admin123@database:5432/ticketsellermadrid_dev?sslmode=disable

然后在代码中直接使用该 URL 初始化 Sequelize:

Docker Hardening
Docker Hardening

专业的Docker安全配置生成器,符合CIS Benchmark v1.8.0标准。

下载
import { Sequelize } from 'sequelize';

const sequelize = new Sequelize(process.env.DATABASE_URL!, {
  dialect: 'postgres',
  dialectOptions: {
    ssl: false, // 双重保险:显式关闭
  },
  logging: console.log,
});
⚠️ 注意:sslmode=disable 是 PostgreSQL 协议标准参数;ssl: false 是 pg 驱动层选项,二者配合使用可彻底规避 SSL 尝试。

方案二:纯对象配置 + 显式 ssl: false
若坚持使用独立参数(如 username/host 等),必须在 dialectOptions 中强制关闭 SSL:

const sequelize = new Sequelize({
  username: process.env.DB_OWNER,
  password: process.env.DB_PASSWORD,
  host: process.env.DB_HOST, // e.g., 'database'
  port: parseInt(process.env.DB_PORT || '5432'),
  database: process.env.DB_NAME,
  dialect: 'postgres',
  dialectOptions: {
    ssl: false, // ✅ 必须设置!否则仍可能触发 SSL handshake
  },
});

❌ 常见误区排除:

  • PGSSLMODE=disable 和 PGREQUIRESSL=0 仅影响 PostgreSQL 服务端行为,不影响客户端连接逻辑;
  • ssl: false 必须置于 dialectOptions 内,而非顶层配置;
  • 若使用连接池(如自定义 Pool),需确保 ssl: false 传入 new Pool({ ssl: false }),但 Sequelize 已封装该逻辑,无需手动创建 Pool。

✅ 最终验证方式:启动容器后,在 app 容器内执行测试连接:

docker exec -it <app-container-name> node -e "
const { Client } = require('pg');
new Client({
  connectionString: 'postgres://postgres:admin123@database:5432/ticketsellermadrid_dev?sslmode=disable'
}).connect().then(() => console.log('✅ SSL-free connection OK')).catch(e => console.error('❌', e.message));
"

总结:PostgreSQL 容器本身无需 SSL 配置,但客户端(Sequelize)必须主动声明不使用 SSL。优先采用带 ?sslmode=disable 的 DATABASE_URL 初始化方式,结构清晰、兼容性强,是 Docker 开发环境的标准实践。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

更多
Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

801

2026.02.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

5036

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1455

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1938

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

10563

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

1060

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3204

2023.09.04

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

1689

2023.09.14

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn