Coolify logoCoolify

域名

您可以轻松地将自己的域名添加到 Coolify 中的应用和服务中。数据库不支持域名配置。

所有域名字段都能根据以下规则生成您的代理配置:

  1. 您需要使用 FQDN(完全限定域名)格式:https://coolify.io
  2. 您可以提供多个域名,用逗号分隔:https://coolify.io,https://www.coolify.io
  3. 您还可以在域名中添加端口,以便代理知道您希望将哪个端口映射到该域名:https://coolify.io:8080,http://api.coolify.io:3000

HTTPS & SSL 证书

Coolify 会自动为您的应用处理 SSL/TLS 证书。当您输入带有 https:// 协议的域名时,后台会自动完成所有配置。

自动 HTTPS 的工作原理

当您使用 https:// 协议输入域名(例如 https://example.com)时:

  1. 自动代理配置 - Coolify 会自动将必要的配置应用到您的反向代理(Traefik 或 Caddy),以便通过 HTTPS 提供应用服务。

  2. 证书签发 - 代理会自动启动从 Let's Encrypt 请求和安装 SSL 证书的流程。

  3. 自动续期 - 证书会在过期前自动续期。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 服务器 字段(逗号分隔列表)。

On this page