配置n8n使用自己的证书颁发机构或自签名证书
您可以将自己的证书颁发机构 (CA) 或自签名证书添加到 n8n。这意味着您能够信任特定的 SSL 证书,而不是信任所有无效证书,这是一个潜在的安全风险。
提示
功能可用性
n8n 1.42.0 及更高版本支持使用自定义证书颁发机构或自签名证书。
要使用此功能,您需要将证书放在文件夹中,并将文件夹挂载到容器中的 /opt/custom-certificates。您映射到 /opt/custom-certificates 的外部路径必须可由容器写入。
Docker
下面的示例假设您有一个名为 pki 的文件夹,该文件夹包含您的证书,位于您运行命令的目录中或 docker compose 文件旁边。
Docker CLI
使用 CLI 时,您可以从命令行使用 -v 标志:
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v ./pki:/opt/custom-certificates \
n8nio/n8n
Docker Compose
name: n8n
services:
n8n:
volumes:
- ./pki:/opt/custom-certificates
container_name: n8n
ports:
- 5678:5678
image: n8nio/n8n
您还应该为导入的证书设置正确的权限。您可以在容器运行后执行此操作(假设 n8n 为容器名称):
docker exec --user 0 n8n chown -R 1000:1000 /opt/custom-certificates
自定义信任存储 的证书要求
支持的证书类型:
- 根 CA 证书:这些是证书颁发机构签署其他证书的证书。信任这些证书可以接受该 CA 签署的所有证书。
- 自签名证书:服务器自己创建和签署的证书。信任这些证书仅可接受与该特定服务器的连接。
您必须使用 PEM 格式:
- 基于文本的格式,具有 BEGIN/END 标记
- 支持的文件扩展名:
.pem、.crt、.cer - 包含公共证书(不需要私钥)
例如:
-----BEGIN CERTIFICATE-----
MIIDXTCCAkWgAwIBAgIJAKoK/heBjcOuMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV
[base64 encoded data]
-----END CERTIFICATE-----
系统不接受:
- DER/二进制格式文件
- PKCS#7 (.p7b) 文件
- PKCS#12(.pfx、.p12)文件
- 私钥文件
- 使用前将这些格式转换为 PEM。
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。