三个简单步骤 根据您的主机环境选择最适合的安装方式

ChurchCRM 产品在线演示 ChurchCRM 官方安装文档

Softaculous 自动安装 vs 手动 cPanel 安装 vs 从 GitHub 直接下载安装

1

Softaculous 自动安装

许多提供 cPanel 的主机服务商均支持一键安装

了解更多 →
2

手动 cPanel 安装

使用 cPanel 文件管理器和 MySQL 工具的分步安装指南

了解更多 →
3

从 GitHub 直接下载安装

通过 FTP 或命令行进行完全自主的安装

了解更多 →

系统要求

系统要求

  • PHP 版本: 8.4+ (required for v7.0.0+)
  • 数据库: 8.0.11+ or MariaDB 10.5+
  • Web 服务器: 2.4+ with mod_rewrite
  • Memory: 256MB minimum (512MB+ recommended)
  • Execution Time: 30+ seconds minimum
  • 磁盘空间: Minimum 500MB available

PHP Extensions

  • php-bcmath, php-curl, php-exif, php-gd
  • php-gettext, php-intl, php-json, php-mbstring
  • php-mysqli, php-soap, php-sodium, php-xml, php-zip

Most hosting providers include these by default

Database User Permissions

The database user must have these permissions:

  • CREATE: To create tables and indexes
  • ALTER: To modify table structures during updates
  • SELECT, INSERT, UPDATE, DELETE: To read and write data
  • EXECUTE: To run stored procedures
  • CREATE VIEW: To create database views

Tip: In cPanel, selecting ALL PRIVILEGES grants all permissions.

方式一：Softaculous 一键安装 / 方式二：手动 cPanel 安装 / 方式三：从 GitHub 直接安装

方式一：Softaculous 一键安装

Recommended if available - Easiest and fastest!

登录您的主机控制面板（cPanel）
  1. Log into your cPanel account
  2. Look for Softaculous or Application Installer in Software section
  3. If you see it, Softaculous is installed!
找到 Softaculous 或"安装软件"板块
  1. Click on Softaculous in cPanel
  2. In the search box, type ChurchCRM
  3. Click on the ChurchCRM icon to view details
搜索 ChurchCRM 并点击安装
  1. Click the green Install Now button
  2. You'll see the installation form
按照提示完成安装
  • Installation URL: Select your primary domain
  • Directory: Leave blank for root, or enter subdirectory name
  • Admin Username: Create a secure username
  • Admin Password: Create a strong password
  • Admin Email: Enter the admin email
  • Site Name: Enter your church name
  1. Click Install button
  2. Softaculous handles everything automatically
  3. Installation completes in 2-5 minutes
  4. Log in with your credentials
That's it! Softaculous automates everything. No technical knowledge required!

方式二：手动 cPanel 安装

If Softaculous isn't available, follow these manual steps.

通过 cPanel MySQL 数据库工具创建 MySQL 数据库
  1. In cPanel, find and click "MySQL Databases"
  2. Create a new database (e.g., churchcrm_db)
  3. Create a new MySQL user with a strong password
  4. Add the user to the database with ALL PRIVILEGES
  5. Note your database name, username, and password
从 GitHub 下载 ChurchCRM
  1. Download from GitHub Releases
  2. Unzip the file on your computer
  3. Get files ready to upload
通过文件管理器或 FTP 上传文件
  1. In cPanel, click "File Manager"
  2. Navigate to public_html directory
  3. Upload all ChurchCRM files
  4. Set file permissions to 644 (files) and 755 (folders)
访问安装地址并按照安装向导操作
  1. Open your browser and go to your ChurchCRM URL
  2. The installation wizard will load automatically
  3. Enter your database information
  4. Create your admin account
  5. Complete the wizard
需要更多帮助？请查阅 GitHub 文档。

方式三：从 GitHub 直接安装

For any web hosting with PHP and MySQL.

从 GitHub 克隆或下载：https://github.com/ChurchCRM/CRM
  1. Go to ChurchCRM Releases
  2. Download the latest zip file
  3. Unzip on your computer
在您的服务器上创建 MySQL 数据库
  1. Use your hosting control panel to create a MySQL database and user
  2. Note the database name, username, and password
通过 FTP 或 SFTP 将文件上传至 Web 服务器
  1. Connect via FTP or use your hosting's file manager
  2. Upload files to web root (public_html, www, or httpdocs)
  3. Set file permissions: files to 644, folders to 755
访问安装地址运行安装程序
  1. Visit your ChurchCRM URL in a browser
  2. The setup wizard will appear
  3. Enter your database credentials
  4. Complete the configuration
完整文档请见 GitHub Wiki

需要帮助？

文档

全面的指南和故障排除

查看文档

社区

与其他教会联系

向社区提问

联系

联系我们寻求直接帮助

联系技术支持

准备好安装了吗？

大多数教会使用 Softaculous 或 cPanel 手动安装。两者都提供完全控制和现有主机集成。

想先看看吗？ 体验在线演示 · 浏览功能