# 勾股OA Docker版

**Repository Path**: dt27/Docker-GouGu-OA

## Basic Information

- **Project Name**: 勾股OA Docker版
- **Description**: 勾股OA Docker版（包含Nginx, PHP-FPM, MySQL）。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-02-10
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 勾股OA Docker版

部署勾股OA Docker版（包含Nginx, PHP-FPM with Composer, MySQL）。


## 目录

- [安装环境要求](#安装环境要求)
- [所用镜像](#所用镜像)
- [目录结构](#目录结构)
- [部署](#部署)
- [鸣谢](#鸣谢)


## 安装环境要求

* [Git](https://git-scm.com/downloads)
* [Docker](https://docs.docker.com/engine/installation/)
* [Docker Compose](https://docs.docker.com/compose/install/)
* make 建议，非必须，make执行脚本比较方便
    > make命令安装包：[make](https://mirrors.nju.edu.cn/gnu/make/)  
    > make命令介绍：[https://zh.wikipedia.org/wiki/Make](https://zh.wikipedia.org/wiki/Make)

### 所用镜像

* [Nginx](https://hub.docker.com/_/nginx/) 最新版
* [MySQL](https://hub.docker.com/_/mysql/) v5.7.44
* [PHP-FPM](https://hub.docker.com/r/nanoninja/php-fpm/) v8.4.3

| 服务       | 端口 |
|------------|------|
| Nginx      | 8008 |
| MySQL      | 3306 | * 容器内部端口，外部如需访问，端口为8006


### 目录结构

```sh
.
├── data
│    └── mysql #MySQL数据库目录
├── etc
│    ├── nginx
│    │    ├── default.conf #此文件不要修改，会被下方的default.template.conf文件覆盖
│    │    └── default.template.conf #Nginx配置文件
│    ├── php
│    │    └── php.ini #PHP配置文件
│    └── ssl #SSL证书文件夹
├── php #PHP容器镜像制作文件
├── web #勾股OA网站主目录
│    ├── app
│    ├── config
│    ├── public
│    ├── composer.json
│    └── ...
├── .env #数据库配置文件
├── docker-compose.yml
├── Makefile
└── README.md
```


## 部署

### 1. 获取项目文件

```sh
git clone https://gitee.com/dt27/Docker-GouGu-OA.git
```

### 2. 修改网站端口及数据库配置

按需修改项目根目录`.env`文件：

>NGINX_PORT=    8008    网站访问端口  
>NGINX_SSL_PORT=8004    网站HTTPS访问端口，需要修改Nginx配置文件开启SSL  
>MYSQL_HOST=    mysql   容器连接数据库时使用此项作为连接地址，默认无需修改  
>MYSQL_PORT=    3306    容器内部端口，默认无需修改  
>MYSQL_EXT_PORT=8006    此端口供外部访问数据库，容器内部直接使用3306端口链接  
>MYSQL_ROOT_PASSWORD=adm!nl2$ 数据库管理员root用户密码  
>MYSQL_DATABASE=oa      数据库名  
>MYSQL_USER=    oa      数据库用户  
>MYSQL_PASSWORD=123456  数据库用户密码
    

### 3. 进入项目目录运行容器

make版与无make版二选一，具体内部执行命令都是一样的。 
 
#### make版：  

```sh
cd Docker-GouGu-OA
make docker-start
```
>程序会自动解压勾股OA最新版v5.6.8到web目录。  
>自动建立 web（Nginx）、php、mysql 三个容器并运行。
>容器建立耗时较长，没有提示错误就耐心等待。

#### 无make版：  

```sh
cd Docker-GouGu-OA
mkdir web
tar -xzf releases/office-v5.6.8.tar.gz -C web
mv web/office-v5.6.8/* web/
mv web/office-v5.6.8/.[^.]* web/
rm -rf web/office-v5.6.8
docker-compose up -d
```

### 4. 确认容器运行成功没有错误

>三个容器都运行成功后，可以访问[http://localhost:8008/](http://localhost:8008/)测试，能打开就是成功了。因为还没有安装依赖，会提示安装依赖，继续第6步安装。
>还可以执行以下命令查看容器日志：

```sh
docker-compose logs -f
```

### 5. 安装PHP依赖包

```sh
docker exec -i php composer install
```
>耗时较长，没有提示错误就耐心等待。

### 6. 打开网址即可访问勾股OA

* [http://localhost:8008/](http://localhost:8008/)
>第一次打开会自动跳转至[http://localhost:8008/install/index.html](http://localhost:8008/install/index.html)进行安装操作  
>根据.env文件中填写的信息进行配置，配置例子：  
>![](https://youjb.com/images/2025/02/10/OA_2025-02-10-18.34.26b1a44e48e48de945.png)


### 鸣谢

- [勾股OA办公系统](https://gitee.com/gouguopen/office)
- [Docker Nginx PHP MySQL](https://github.com/nanoninja/docker-nginx-php-mysql)