域名
您可以轻松地将自己的域名添加到 Coolify 中的应用和服务中。数据库不支持域名配置。
所有域名字段都能根据以下规则生成您的代理配置:
- 您需要使用 FQDN(完全限定域名)格式:
https://coolify.io - 您可以提供多个域名,用逗号分隔:
https://coolify.io,https://www.coolify.io - 您还可以在域名中添加端口,以便代理知道您希望将哪个端口映射到该域名:
https://coolify.io:8080,http://api.coolify.io:3000
HTTPS & SSL 证书
Coolify 会自动为您的应用处理 SSL/TLS 证书。当您输入带有 https:// 协议的域名时,后台会自动完成所有配置。
自动 HTTPS 的工作原理
当您使用 https:// 协议输入域名(例如 https://example.com)时:
-
自动代理配置 - Coolify 会自动将必要的配置应用到您的反向代理(Traefik 或 Caddy),以便通过 HTTPS 提供应用服务。
-
证书签发 - 代理会自动启动从 Let's Encrypt 请求和安装 SSL 证书的流程。
-
自动续期 - 证书会在过期前自动续期。Let's Encrypt 证书有效期为 90 天,Coolify 会无缝处理续期。
提示
您无需进行任何特殊操作即可启用 HTTPS。只需在输入域名时使用 https://,Coolify 会自动处理其余部分。
自签名证书
如果无法从 Let's Encrypt 自动签发证书,Coolify 代理将提供自签名证书以保持应用的可用性。这意味着您的应用仍然可以访问,但浏览器会显示安全警告。
故障排除
如果您在浏览器中看到证书警告,或者您的应用显示自签名证书,请参阅 Let's Encrypt 无法工作 故障排除指南以获取详细解决方案。
基于路径的路由
您可以通过在域名后附加路径,将流量路由到不同的应用和服务。这允许多个应用共享同一个域名,同时通过不同的路径进行访问。
格式:https://domain.com/path 或带自定义端口:https://domain.com:3000/path
端口位置
当同时使用端口和路径时,端口必须位于域名之后但在路径之前。
- 正确:
https://coolify.io:3000/api - 错误:
https://coolify.io/api:3000
路径优先级的工作原理
Coolify 会自动应用基于路径的路由优先级规则。更具体的路径优先级高于较不具体的路径:
/api/v2/users→ 最高优先级/api/v2→ 中等优先级/api→ 较低优先级/→ 最低优先级(根/回退)
这意味着您可以安全地在同一域名上部署多个应用,而无需担心路由冲突。
健康要求
为了使基于路径的路由正常工作,提供特定路径的应用必须正在运行且健康。如果应用变得不健康或停止响应,对该路径的流量将回退到提供根域名(/)的应用。
示例
如果您有:
- 应用 A 提供
https://coolify.io/(根) - 应用 B 提供
https://coolify.io/api
当应用 B 变得不健康时,对 /api 的请求将被路由到应用 A。
有关 Coolify 代理如何读取和解释资源健康状况的更多信息,请参阅我们的 健康检查页面。
捕获多个域名
Coolify 支持多租户。当使用 Traefik 时,您可以通过编辑应用或服务的 Container Labels 并定义 HostRegexp 规则来自动捕获多个域名。
通配符 & SSL 证书
Coolify 代理无法为通配符域名签发 SSL 证书。对于特定域名的子域名,您可以选择生成 通配符 SSL 证书。
通配符域名
您可以为服务器设置通配符域名(例如:http://example.com),以便轻松为连接到该服务器的所有资源分配生成的域名。更多详情
DNS 验证
自版本 beta.191 起,Coolify 将使用 1.1.1.1 Cloudflare DNS 服务器验证您域名的 DNS 记录。
如果您想使用不同的 DNS 服务器,请转到 设置 > 高级 页面并更改 自定义 DNS 服务器 字段(逗号分隔列表)。
