搭建论坛程序——Flarum

Flarum 是一款非常简洁的开源论坛软件。它响应快速、简便易用，拥有打造一片成功的社区所需的所有功能

服务器软件源换源脚本

下载换源脚本
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-linux -o chsrc; chmod +x ./chsrc
自动测速，寻找最快者，换源
./chsrc set ubuntu  #根据系统来配置

一、在线安装

1.安装php

sudo apt install php php-fpm php-mysql php-curl php-dom php-gd php-json php-mbstring php-zip php-fileinfo php-xml php-bcmath

2.安装数据库mysql、MariaDB都可，建立数据库

mysql

CREATE DATABASE flarum;
CREATE USER 'flarum'@'localhost' IDENTIFIED BY 'password';

GRANT ALL PRIVILEGES ON flarum.* TO 'flarum'@'localhost';

FLUSH PRIVILEGES;
EXIT;

3.安装Composer

境外服务器执行如下命令：
curl -s https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
composer -V   #显示版本说明安装成功

国内服务器执行如下命令：
# 下载本体文件
wget https://mirrors.tencent.com/composer/composer.phar
# 赋予执行权限
sudo chmod +x composer.phar
# 全局启用 `composer` 指令
sudo mv composer.phar  /usr/local/bin/composer
# 切换到腾讯云源
composer config -g repos.packagist composer https://mirrors.tencent.com/composer/
composer -V  #显示版本说明安装成功

4.安装Flarum

mkdir -p /data/www/html/flarum
cd /data/www/html/flarum
composer create-project flarum/flarum .
composer install
chown -R www-data:www-data /data/www/html/flarum/
chmod -R 755 /data/www/html/flarum/

5.Flarum 根目录附带了一个 .nginx.conf 文件，请确保它有正确生成。假如您已经在 Nginx 中建立了一个 PHP 站点，您应当在站点配置中添加以下内容，以导入默认的重写规则：

include /<Flarum 路径>/.nginx.conf;

6.nginx配置

server {
    listen 80;
    server_name 域名.com;
    # Redirect HTTP to HTTPS
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    server_name 域名.com;
    ssl_certificate /etc/ssl证书.pem;
    ssl_certificate_key /etc/ssl证书.pem;
    include /data/www/html/flarum/.nginx.conf;
    root /data/www/html/flarum/public;
    index index.html index.php;
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass  unix:/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include  fastcgi_params;
    }
}

7.访问域名即可。

二、通过解压缩归档进行安装

1.先自行安装php,mysql,Composer等

通过压缩包安装可以避免Composer 安装项目依赖的时候会占用比较高的内存。

2.创建目录

mkdir /data/www/html/flarum
cd /data/www/html/flarum

3.下载压缩包（下载本机php版本与官网相匹配的Flarum包，否则会有报错）

官方给出的所有已经打包好了的 Flarum 本体文件下载链接：安装 | Flarum Documentation，根据你自己的 php 版本和需求来选择

https://github.com/flarum/installation-packages/raw/main/packages/v1.x/flarum-v1.x-php8.3.tar.gz

4.解压并修改权限

tar -zxvf flarum-v1.x-php8.3.tar.gz
chown -R www-data:www-data /data/www/html/flarum/
chmod -R 755 /data/www/html/flarum/

5.mysql，nginx配置跟上面在线安装的配置一样

6.以上（在线安装，解压安装）安装插件命令须在/data/www/html/flarum/执行

composer require flarum-lang/chinese-simplified

7.以上（在线安装，解压安装）换国内插件源插件命令

sed -i 's/dl-cdn.alpinelinux.org/mirrors.ustc.edu.cn/g' /etc/apk/repositories && apk update && apk add git && composer config repo.packagist composer https://mirrors.aliyun.com/composer/ && /init

8.访问域名即可。

三、docker-compose安装

1.创建一下安装的目录：

mkdir -p /root/data/docker_data/flarum

cd /root/data/docker_data/flarum

nano docker-compose.yml

2.docker-compose.yml填入以下内容：

services:
  mariadb:
    image: mariadb:10.5
    container_name: mariadb
    environment:
      - MYSQL_ROOT_PASSWORD=123456
      - MYSQL_DATABASE=flarum
      - MYSQL_USER=flarum
      - MYSQL_PASSWORD=123456
    volumes:
      - /root/data/docker_data/flarum/docker/mysql/db:/var/lib/mysql  # 数据映射到本地，数据不会因为Docker停止而丢失
    restart: unless-stopped

  flarum:
    image: mondedie/flarum:stable
    container_name: flarum
    env_file:
      - /root/data/docker_data/flarum/flarum/flarum.env   # 创建一个flarum.env
    volumes:   # 数据映射到本地，数据不会因为Docker停止而丢失
      - /root/data/docker_data/flarum/flarum/assets:/flarum/app/public/assets
      - /root/data/docker_data/flarum/flarum/extensions:/flarum/app/extensions
      - /root/data/docker_data/flarum/flarum/storage/logs:/flarum/app/storage/logs
      - /root/data/docker_data/flarum/flarum/nginx:/etc/nginx/flarum
    ports:
      - 8080:8888   # 左边的8080可以自己调整端口号，右边的8888不要改
    restart: unless-stopped
    depends_on:
      - mariadb

3.然后创建一个flarum.env文件

mkdir -p /root/data/docker_data/flarum/flarum
cd /root/data/docker_data/flarum/flarum
nano /root/data/docker_data/flarum/flarum/flarum.env

4.输入下面的内容：

DEBUG=false
FORUM_URL=http://103.189.141.150:8080     # 可以自行修改，这个是论坛的网站  注意域名地址没有的话 要填IP+port 要不然会报错

# Database configuration
DB_HOST=mariadb
#DB_HOST=127.0.0.1
DB_NAME=flarum
DB_USER=flarum
DB_PASS=123456    # 可以自行修改，但是要与docker-compose上面的一致
DB_PREF=flarum_
DB_PORT=3306

# User admin flarum (environment variable for first installation)
# /!\ admin password must contain at least 8 characters /!\
FLARUM_ADMIN_USER=admin          # 可以自行修改，但是要与docker-compose上面的一致
FLARUM_ADMIN_PASS=123456  # 可以自行修改，但是要与docker-compose上面的一致
FLARUM_ADMIN_MAIL=admin@domain.tld  # 可以自行修改，修改成自己的邮箱
FLARUM_TITLE=Test flarum  # 可以自行修改，这个是论坛的标题

5.没问题的话，ctrl+x退出，按y保存，enter确认。

cd /root/data/docker_data/flarum

6.运行：

docker-compose -f docker-compose.yml up -d

7.访问：http:服务ip:8080 即可。

8.管理员后台ttp:服务ip:8080/admin

9.默认 Flarum 只支持英文，但是有中文扩展

https://flarum.org/extensions?tableSearch=upload&tableFilters[exclude_forks][isActive]=false

10.在 SSH 客户端的命令行中执行下面的命令

## 进入容器
docker exec --user root -it flarum /bin/sh
##国内服务器需要配置新的源，否则下载慢甚至失败，进入容器执行以下命令，境外机器无需执行此命令。
sed -i 's/dl-cdn.alpinelinux.org/mirrors.ustc.edu.cn/g' /etc/apk/repositories && apk update && apk add git && composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 

## 进目录
cd /flarum/app

## 安装中文语言包
composer require flarum-lang/chinese-simplified

## 清除缓存
php flarum cache:clear

11.不进入容器可以执行下面的命令

安装插件：
sudo docker exec -ti flarum extension require [扩展名/扩展名]
移除插件：
sudo docker exec -ti flarum extension remove [扩展名/扩展名]
列出扩展列表：
sudo docker exec -ti flarum extension list
首先安装中文插件：
sudo docker exec -ti flarum extension require flarum-lang/chinese-simplified

12.安装完成后，在管理员后台能看到 Languages 中多了简体中文

13.安装图片上传图片插件，同样去插件中心获取，有操作步骤。

14.进入容器终端执行如下命令即可安装。

15.更新

cp -r /root/data/docker_data/flarum /root/data/docker_data/flarum.archive  # 万事先备份，以防万一

cd /root/data/docker_data/flarum  # 进入docker-compose所在的文件夹

docker-compose pull    # 拉取最新的镜像

docker-compose up -d   # 重新更新当前镜像