常见问题解答

如何选择 Docker 部署还是传统部署？

推荐使用 Docker 部署，因为它可以自动配置所有依赖环境，避免版本冲突问题。如果您的服务器已经有完整的 PHP+MySQL+Redis 环境，且希望更灵活地控制配置，可以选择传统部署方式。

Docker 部署时提示端口被占用怎么办？

默认情况下，系统会使用 80 端口（Web）、3306 端口（MySQL）和 6379 端口（Redis）。如果这些端口已被占用，可以修改 docker-compose.yml 文件中的端口映射，例如将 80:80 改为 8080:80。

部署后访问提示 500 错误？

请检查以下几点：

• 确认数据库连接配置正确（检查 .env 文件）
• 确认数据库已正确初始化（导入 SQL 文件）
• 检查 PHP 错误日志，定位具体错误原因
• 确认文件权限正确，特别是 storage 和 cache 目录需要可写权限

需要什么样的服务器配置？

最低配置：1核 CPU、2GB 内存、5GB 硬盘空间。推荐配置：2核 CPU、4GB 内存、20GB 硬盘空间。对于管理大量证书（1000+ 个域名）的场景，建议使用 4GB 以上内存。

如何配置 AllinSSL 接口？

登录系统后，进入「系统设置」→「接口配置」，填入您的 AllinSSL API Key 和 API Secret。保存后点击「测试连接」确认配置正确。首次配置成功后，系统会自动同步证书数据。

如何设置邮件提醒功能？

在「系统设置」→「邮件配置」中，填写 SMTP 服务器信息：

• SMTP 服务器地址（如：smtp.qq.com）
• SMTP 端口（通常为 465 或 587）
• 发件人邮箱和密码/授权码
• 发件人名称

配置完成后，可以点击「发送测试邮件」验证配置是否正确。

可以设置多次提醒吗？

可以。在「提醒设置」中，您可以配置多个提醒时间点，例如：提前 30 天、15 天、7 天、3 天、1 天各发送一次提醒。每个域名都可以单独设置提醒规则。

如何添加团队成员？

在「用户管理」中点击「添加成员」，填写成员信息并选择权限级别：管理员（全部权限）、执行（可查看和处理提醒）、只读（仅查看数据）。添加后系统会发送邀请邮件给新成员。

如何批量导入证书数据？

系统支持 Excel 批量导入。在「证书列表」页面点击「导入」，下载模板文件，按照模板格式填写域名、负责人、提醒邮箱等信息，然后上传文件即可。

AllinSSL 同步频率是多久？

默认每 6 小时自动同步一次。您也可以在「证书列表」页面手动点击「立即同步」按钮进行实时同步。同步频率可以在「系统设置」中自定义。

如何按客户分组管理证书？

在添加或编辑证书时，可以为每个域名设置「客户标签」或「分组」。之后在证书列表中可以按标签筛选，也可以为不同客户分配不同的负责人和提醒规则。

如何对接自己的监控或工单系统？

系统提供 Webhook 接口和 API 接口。您可以在「系统设置」→「Webhook 配置」中设置回调地址，当证书即将到期或提醒发送时，系统会向您的接口推送数据。详细 API 文档请查看部署包中的 API.md 文件。

系统是否完全免费？

是的，SSL通知助手是完全开源免费的项目，您可以无限制地使用、修改和分发。我们不收取任何费用，也没有功能限制或使用期限。

数据安全吗？会不会泄露？

系统采用自托管部署，所有数据都存储在您自己的服务器上，不会经过任何第三方。敏感信息（如 API 密钥）采用加密存储，操作日志完整记录，确保数据安全可控。

支持多语言吗？

当前版本仅支持简体中文。如果您需要其他语言支持，欢迎在 GitHub 上提交 Issue 或参与翻译贡献。

如何升级到最新版本？

对于 Docker 部署：执行 docker-compose pull 拉取最新镜像，然后 docker-compose up -d 重启服务。对于传统部署：下载最新代码包，覆盖文件（注意备份配置文件），然后运行数据库迁移脚本。