Q: 如何修复从 master 构建 Cypht Docker 镜像时出现的 "COPY <<EOF ... no source files were specified" 错误？

该 Dockerfile 使用了 BuildKit heredoc 语法,而旧版的 `docker build` 路径不支持该语法。请在仓库根目录下改用 Buildx: ```sh docker buildx build . --platform linux/amd64 -t dockerid/cypht:master docker ``` 将 `dockerid/cypht:master` 替换为你想要的镜像名称。如果尚未配置 Buildx,请先使用 `docker buildx create --use` 创建并选择一个构建器。

Q: 如何修复 Cypht 定时邮件发送失败的问题,报错"Failed to authenticate to the SMTP server"、$smtpId 未定义,以及 HTML 被以纯文本形式发送?

这是 Cypht 2.9.0 定时发送管道中的一个 bug,而不是 SMTP 凭据问题。当邮件使用 `X-Profile-ID` SMTP 配置文件时,调度器不会初始化 `$smtpId`,导致身份验证失败。仅修补该变量可以让发送恢复正常,但同一管道仍可能将邮件构建为 `text/plain`,从而暴露 HTML 标签,并在 `modules/smtp/modules.php` 第 1680 行记录 `Undefined array key 1/2`。请将 Cypht/Docker 镜像升级到包含 issue #1981 修复的构建版本,然后重新创建容器:`docker pull cypht/cypht:latest && docker compose up -d`(或者使用第一个修复版本/标签代替 `latest`)。确认定时邮件使用相同的 SMTP 配置文件并以 `multipart/alternative`/`text/html` MIME 结构发送。如果无法立即升级,请使用立即发送代替定时发送;仅部分修补 `$smtpId` 是不够的。

Q: 为什么在Travis CI上使用BrowserStack和Selenium时Safari测试会失败？

Safari测试在Travis上常因最大化浏览器窗口的问题而失败，很可能是由于Selenium或BrowserStack环境中的版本差异。解决方法：1) 对Safari测试禁用'exit on error'以保持CI持续运行（如同本仓库所做）。2) 在本地，识别并编码绕过那5个持续失败的测试。确保本地和CI环境中的版本一致。

Question 1

为什么 Cypht 在 Docker 中登录后会因 'invalid source origin' 错误而立即退出登录？

Accepted Answer

这是 Cypht 2.12.2 中的一个已知 bug：当通过 LAN IP 和非标准端口（例如 http://192.168.1.240:8080）直接访问 Cypht 时，即使 Host 和 Origin 请求头相匹配，Origin 验证也会失败。会话在创建后会立即被销毁。

修复方法：升级到 Cypht 2.13.0，该版本已解决此问题：
```bash
docker pull cypht/cypht:2.13.0
```

2.12.2 的临时解决方案：在环境配置中禁用 Origin 检查（对于不暴露于 Internet、仅限 LAN/VPN 使用的实例是可以接受的）：
```env
DISABLE_ORIGIN_CHECK=true
DISABLE_IP_CHECK=true
DISABLE_FINGERPRINT=false
```
然后重启容器。请注意，这会禁用一项 CSRF 防护机制，因此升级到 2.13.0 是首选解决方案。

Question 2

为什么Cypht Docker容器在使用SQLite时会失败并显示“Unable to connect to database”？

Accepted Answer

入口点脚本在未显式设置DB_HOST、DB_USER或DB_PASS时，默认会检查远程数据库连接，即使已设置DB_DRIVER=sqlite也是如此。要强制使用本地SQLite，请在容器配置中将这些变量设置为空字符串：Environment=DB_HOST=, Environment=DB_USER=, Environment=DB_PASS=。这会绕过远程连接尝试，并使用指定的SQLite文件。

Question 3

如何修复从 master 构建 Cypht Docker 镜像时出现的 "COPY <<EOF ... no source files were specified" 错误？

Accepted Answer

该 Dockerfile 使用了 BuildKit heredoc 语法,而旧版的 `docker build` 路径不支持该语法。请在仓库根目录下改用 Buildx:

```sh
docker buildx build . --platform linux/amd64 -t dockerid/cypht:master docker
```

将 `dockerid/cypht:master` 替换为你想要的镜像名称。如果尚未配置 Buildx,请先使用 `docker buildx create --use` 创建并选择一个构建器。

Question 4

如何修复 Cypht 定时邮件发送失败的问题,报错"Failed to authenticate to the SMTP server"、$smtpId 未定义,以及 HTML 被以纯文本形式发送?

Accepted Answer

这是 Cypht 2.9.0 定时发送管道中的一个 bug,而不是 SMTP 凭据问题。当邮件使用 `X-Profile-ID` SMTP 配置文件时,调度器不会初始化 `$smtpId`,导致身份验证失败。仅修补该变量可以让发送恢复正常,但同一管道仍可能将邮件构建为 `text/plain`,从而暴露 HTML 标签,并在 `modules/smtp/modules.php` 第 1680 行记录 `Undefined array key 1/2`。请将 Cypht/Docker 镜像升级到包含 issue #1981 修复的构建版本,然后重新创建容器:`docker pull cypht/cypht:latest && docker compose up -d`(或者使用第一个修复版本/标签代替 `latest`)。确认定时邮件使用相同的 SMTP 配置文件并以 `multipart/alternative`/`text/html` MIME 结构发送。如果无法立即升级,请使用立即发送代替定时发送;仅部分修补 `$smtpId` 是不够的。

Question 5

为什么在Travis CI上使用BrowserStack和Selenium时Safari测试会失败？

Accepted Answer

Safari测试在Travis上常因最大化浏览器窗口的问题而失败，很可能是由于Selenium或BrowserStack环境中的版本差异。解决方法：1) 对Safari测试禁用'exit on error'以保持CI持续运行（如同本仓库所做）。2) 在本地，识别并编码绕过那5个持续失败的测试。确保本地和CI环境中的版本一致。

Cypht

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐