常见问题
关于 ChurchCRM 安装、登录、排错和最佳实践的常见问题。
这里汇总了 ChurchCRM 在部署、日常使用与故障排查中的高频问题与答案。
是的。ChurchCRM 完全免费并且开源，没有授权费用。
ChurchCRM 不提供托管服务——该项目没有运营任何云服务器供用户订阅使用。您需要自行提供 运行软件的环境。ChurchCRM 仅支持 LAMP 技术栈（Linux、Apache、MySQL、PHP），必须在 Linux 环境中运行。不过，如果您没有服务器，有两个实用选择。
共享主机（推荐大多数教会使用）： 在任何主流服务商（Hostinger、Bluehost、SiteGround、 DreamHost 等）购买共享主机账户，这些服务均运行 Linux，可获得 ChurchCRM 所需的全部 环境——PHP、MySQL 和 Apache——每月费用约 3–10 美元。大多数共享主机都包含 Softaculous， 可一键安装 ChurchCRM。这是最常见的部署方式，全体会众可随时从任意设备访问。
使用 Docker 的本地计算机（适合测试或单用户使用）： 在 Windows、Mac 或 Linux 上 本地运行 ChurchCRM 的最佳方式是使用 Docker——它会自动提供正确的 Linux 和 LAMP 环境， 无需手动配置服务器。Docker Desktop 免费下载，官方 ChurchCRM Docker 镜像只需一条命令 即可完成全部配置。重要限制是：本地安装只能在该计算机上访问——除非其他人与您在同一 局域网内并经过手动配置，否则其他同工无法从自己的设备登录。
如果预算有限，多家主机服务商提供每月不到 5 美元的套餐，足以运行适合任何规模教会的 ChurchCRM。
请使用本地化演示页面：/zh/demo.html。
ChurchCRM 需要 PHP 8.4+、MySQL 8.0+（或兼容的 MariaDB）以及启用 mod_rewrite 的 Apache。
请参考安装指南：/zh/install.html。如果主机提供 Softaculous，通常是最快的方法。
全新安装会创建管理员账号：用户名
admin，密码 changeme。首次登录后请立即修改密码。先检查 Apache mod_rewrite 是否启用，以及重写规则是否正确。
先检查文件权限和服务器日志。官方说明：https://docs.churchcrm.io/administration/500-error
在系统设置中启用应用日志，并在排错时提高 PHP 错误报告级别。
将文件上传到 Images 目录，并在报表设置中填写该路径。不要直接覆盖系统默认文件，以免升级时丢失。
提问请使用 GitHub Discussions，确认缺陷请提交 GitHub Issues：https://github.com/ChurchCRM/CRM/discussions 和 https://github.com/ChurchCRM/CRM/issues
最大的变化是全面重新设计的界面（Tabler/Bootstrap 5），包括深色模式、插件系统、无需 API 密钥的 OpenStreetMap 地图，以及支持 46 种语言。
不需要。地图使用 OpenStreetMap 和 Leaflet，无需任何 API 密钥。
可以。ChurchCRM 包括插件系统和社区插件注册表，可直接从管理面板安装经过审核的插件。
有。每位用户可在 我的设置 → 主题 中独立开启深色模式。
备份数据库，用新版本替换应用文件，然后访问网站。数据库迁移在应用启动时自动执行。