必须切换国内镜像源才能顺利安装flarum/flarum，因默认packagist.org在国内DNS解析慢、连接易重置，导致create-project卡在依赖下载并报Connection timed out等错误；推荐腾讯云或阿里云镜像，全局执行composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，并确保空目录、权限正确、PHP≥7.3且启用必要扩展。
直接用默认源安装 flarum/flarum 极大概率失败或超时——因为 Packagist 官方源在国内访问不稳定，composer create-project 卡在下载依赖阶段是常态。必须切换国内镜像源才能顺利跑通。
为什么默认源会卡住或报错
Composer 默认走 packagist.org，该域名在国内 DNS 解析慢、连接常被重置，尤其下载 flarum 这类含大量 PHP 包（如 illuminate/ 系列、symfony/ 组件）的项目时，单个包超时就会中断整个安装流程。常见错误包括：Connection timed out、Failed to decode response、Could not fetch。
切换国内源的两种可靠方式
推荐使用腾讯云或阿里云镜像，稳定性高且无需账号：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局切换（影响所有 Composer 项目）：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 仅当前项目切换（更安全，避免污染其他项目）：
composer config repo.packagist composer https://packagist.phpcomposer.com（注意：此地址已停用，改用腾讯或阿里源） - 验证是否生效：
composer config -g repo.packagist应输出镜像地址；composer show -p可看到实际使用的源
安装 Flarum 时必须配合的权限与路径操作
即使源换对了，composer create-project flarum/flarum . --stability=beta 仍可能因权限或路径问题失败：
- 必须在空目录下执行，不能在已有文件的网站根目录直接运行（否则会提示
Destination directory is not empty） -
storage/和public/目录需设为可写：chmod -R 755 storage public（宝塔用户注意：777 不必要，755 + 正确属主即可） - 如果用宝塔面板，先清空网站目录，再 SSH 进入该路径执行命令，不要跳过
cd /www/wwwroot/your_domain - PHP 版本必须 ≥7.3（推荐 8.0+），且启用
fileinfo、mbstring、pdo_mysql扩展，缺一则composer install阶段报错
装完中文语言包还显示英文？检查这三处
装完 flarum-lang/chinese-simplified 后前台仍是英文，不是插件没装上，而是配置链断在中间：
- 确认执行了
php flarum cache:clear，否则后台语言开关不生效 - 后台 →
Language页面里，简体中文状态必须点Enabled（灰色按钮要点击变蓝） - 前台右上角语言切换菜单里，选中
简体中文后，还要点保存（有些版本需刷新两次才加载新 locale 文件） - 若仍无效，检查
config.php中是否硬编码了'locale' => 'en'，手动改为'zh_CN'
最易被忽略的是：安装过程中用了 IP 访问（比如 http://192.168.1.100），后续绑域名会导致 CSRF token 或 asset 路径错乱，连后台都进不去——务必从一开始用正式域名访问安装页。
