docs/install.md · 深蓝/lpszoj

环境需求
------------

在 Linux 环境下安装。判题机是在 Linux 环境下写的，Windows 下无法运行判题机。

搭建 LNMP (或 LAMP) 环境：PHP 7.x或8.x、MySQL 5.7或以上、Nginx / Apache2

本教程分为 **一键安装脚本**、**Docker安装脚本（1Panel面板安装）**、**手动安装过程**。这三个过程选择其中一个即可。

# 一键安装与Docker安装后管理员账号： `admin`，密码：`123456`。

测评机如需加入开机自动启动，请安装完后看 [开机启动](./autostart.md)

一键安装脚本
-----------

> 适合在新装的系统或未运行 Web (nginx、mysql)有关服务的系统中。

**注意！！！此方法目前仅在 Ubuntu 20/22/23、Debian 10/11/12、Alpine 3.18/3.19、CentOS9/Rocky Linux9 中测试通过。其它 Linux 系统还未测试。**

执行以下命令，进行安装(如果安装过程中出现错误，可以再次尝试运行安装命令)：

**Ubuntu运行**：

```sh
wget https://gitee.com/yhssdl/lpszoj/raw/master/docs/install.sh && sudo bash install.sh
```

**Debian(Armbian) 11运行(root账号)**：

```sh
apt install -y wget && wget https://gitee.com/yhssdl/lpszoj/raw/master/docs/install.sh && bash install.sh
```

**Alpine运行(root账号)**：

> 将软件源更换为国内的源。
  
```sh
sed -i 's/dl-cdn.alpinelinux.org/mirrors.ustc.edu.cn/g' /etc/apk/repositories
sed -i 's/#http/http/g' /etc/apk/repositories
```

> 运行安装脚本
  
```sh
apk add bash wget && wget https://gitee.com/yhssdl/lpszoj/raw/master/docs/install.sh && bash install.sh
```

**CentOS运行**：

```sh
yum install wget -y && wget https://gitee.com/yhssdl/lpszoj/raw/master/docs/install.sh && sudo bash install.sh
```

该脚本将 OJ 安装在 `/var/www/lpszoj` 目录下。

安装后管理员账号： `admin`，密码：`123456`。

**初始默认密码过于简单，请立即登陆修改**。

Docker 安装脚本（现已支持arm64与amd64两种架构）
-----------
- 1.先安装好 Docker 环境，[详见教程](https://gitee.com/yhssdl/docs/blob/master/docker.md)
- 2.lpszoj 系统已经制作了 docker 镜像，可直接使用 docker 来运行，镜像名称为：yhssdl/lpszoj

```sh
docker run -d -p 8088:80 --name lpszoj yhssdl/lpszoj 
```

以上命令中，映射到 8088 端口，你可以通过 http://主机IP:8088 来访问，当然你也docker可以修改映射端口。

- 3.如果你想将一些关键数据同步保存到主机中，可以先创建挂载卷，位置是在 /var/lib/docker/volume 中，以后在备份或修改文件就可以在该目录中进行，无需进入 Docker 容器中。

> 创建挂载卷。

```sh
docker volume create www
```

> 运行 lpszoj 镜像。

```sh
docker run -d -p 8088:80 \
--mount type=volume,source=www,destination=/app/lpszoj \
--name lpszoj yhssdl/lpszoj
```

- 3.将 lpszoj 的容器设置为自启动。

```sh
docker update --restart=always lpszoj
```

手动安装过程
------------
Debian + 1Panel面板 + OJ系统安装WORD教程 `[推荐]`：[点击下载教程](1Panel+OJ系统安装教程.docx)

Debian + 宝塔面板 + OJ系统安装WORD教程：[点击下载教程](宝塔面板+OJ系统安装教程.docx)

搭建 LNMP (或 LAMP) 环境，可以参考：[LNMP 环境搭建](environment.md)。

1. 下载　`lpszoj`。
    运行命令：

~~~sh
    git clone https://gitee.com/yhssdl/lpszoj.git
    ~~~

2. 配置 Web 端
    1. 配置数据库信息
    
        在 `lpszoj/config/db.php` 文件中配置数据库信息，请根据数据库实际情况修改相应的 `username` 和 `password`。在服务器上可以使用 `vim` 或 `nano` 命令进行编辑。例如：
        
        ```php
        return [
            'class' => 'yii\db\Connection',
            'dsn' => 'mysql:host=localhost;dbname=ojdate',
            'username' => 'root',
            'password' => '123456',
            'charset' => 'utf8mb4',
        ];
        ``` 
        **注意：** Web 程序不会为你创建数据库，需要你自己手动创建该数据库（创建方法：运行 `mysql -u root -p` 登录MySQL，然后 `create database ojdate;`，执行 `quit;` 可退出MySQL，注意此处命令有分号）。

2. 执行安装命令
    
        进入 lpszoj 目录，在命令行运行 `./yii install` 来安装。安装过程会自动导入所需的 SQL 数据，并且需要你根据提示输入 OJ 管理员的账号密码。
    
    3. 修改 `/etc/nginx/sites-enabled/default` 文件，需要修改的配置：
        ```txt
        server {
                listen 80 default_server;
                listen [::]:80 default_server;

# 修改 root 后的路径为 lpszoj/web 目录所对应的路径。看你具体把 lpszoj 目录放到哪里。
                root /var/www/lpszoj/web;

index index.php;

server_name _;

location / {
                        try_files $uri $uri/ /index.php?$args;
                }

location ~ \.php$ {
                        include snippets/fastcgi-php.conf;
                        fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
                }
        }
        ```
        修改后使用 `sudo nginx -s reload` 重现加载配置
    做好以上步骤后便可以使用 Web 端：
    
    ~~~
    http://ip地址
    本地主机则访问  http://127.0.0.1
    ~~~
    
    此时还不能进行判题，需配置判题机才能判题。
    
3. 配置判题机
    1. 安装编译的依赖，运行命令：`sudo apt install libmysqlclient-dev libmysql++-dev`（如果是CentOS，可以运行 `yum install -y mysql-devel`，如果是CentOS9/Rocky9中，运行`yum install -y mariadb-connector-c-devel`）(如果是Debian 11，可以运行`apt install libmariadb-dev-compat libmariadb-dev`）
    2. 创建一个用于判题的用户，运行命令：`sudo useradd -m -u 1536 judge`
    3. 将控制台切换到 `judge` 目录（即运行 `cd judge`命令），然后运行 `make` 命令
    4. 运行 `sudo ./dispatcher` 命令
    5. 如果在CentOS中编译C或C++程序时，出现“找不到-lm，-lc”等情况，可以运行命令：yum install glibc-static libstdc++-static（如果是CentOS 8中安装失败，可以先运行yum install -y yum-utils，再运行yum-config-manager --enable powertools与yum-config-manager --enable PowerTools后，再次尝试安装，如果是CentOS 9中，，可以先运行yum install -y yum-utils，再运行yum-config-manager --enable crb）

4. 配置配置多边形系统
    
    1. 将控制台切换到 `polygon` 目录（即运行 `cd polygon`命令），然后运行 `make` 命令
    2. 运行 `sudo ./polygon` 命令

### 安装过程执行命令如下：

注意，在下面这些命令中，有 `vim` 开头的是需要编辑文件的，若不会使用 `vim`，则将 `vim` 改成 `nano`。执行 `nano  文件名` 命令后会进入 nano 编辑器并打开文件，修改好用组合键 `Ctrl X` 退出。

##### 创建数据库

~~~sh
$ mysql -u root -p
mysql> create database lpszoj;
mysql> quit;
~~~

##### 安装过程

在以下命令中，`#` 字符及之后的字符为注释，不用输入
~~~sh
$ git clone https://gitee.com/yhssdl/lpszoj.git
$ cd lpszoj
$ vim config/db.php
$ ./yii install
$ sudo useradd -m -u 1536 judge
$ cd judge
$ sudo apt install libmysqlclient-dev libmysql++-dev
$ make
$ sudo ./dispatcher
$ cd ../polygon
$ make
$ sudo ./polygon
~~~

深蓝/lpszoj

About

Releases

Contributors

Language(Optional)

Activities