zls-docker

KO | EN

gitlite — search

#python #react #ai #golang #go #android #rust #linux #docker #macos #java #windows #awesome-list #openai

(★ 70)

开箱即用的面向生产和开发环境的 Docker 配置 - Docker configuration for production and development environments

zls-docker 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# zls-docker

开箱即用的面向生产和开发环境的 Docker 镜像

[详细文档](https://docs.73zls.com/zls-docker/#/)

## 目录结构

```
.
├── config
│   ├── mysql
│   │   └── mysql.cnf                      mysql.cnf 配置
│   ├── caddy                              caddy 配置目录
│   ├── nginx
│   │   ├── conf.d                         vhost 配置目录
│   │   │   ├── localhost.conf             默认站点配置
│   │   │   └── localhost_https.conf       默认站点HTTPS配置
│   │   └── nginx.conf                     nginx.conf 配置
│   ├── php
│   │   ├── php-fpm.conf                   php-fpm.conf 配置
│   │   └── php.ini                        php.ini 配置
│   ├── redis
│   │   └── redis.conf                     redis.conf 配置
│   ├── lua                                lua 脚本
│   │   └── waf
│   │       └── config.lua                 web 防火墙配置
├── data                                   数据目录
├── logs                                   日志目录
├── docker-compose.yml                     docker-compose 编排文件
├── run.sh                                 执行脚本
└── www                                    站点目录
    └── localhost                          默认站点
```

## 快速上手

1. 安装 git、 docker 和 docker-compose

docker >=19

docker-compose >= 3

系统自带的 yum、apt 安装版本可能会过低了，

如不清楚如果不熟悉怎么安装 docker，

执行可以拉取项目后执行 ./run.sh installDocker 查看相关安装命令，

或查看 [docker.md](./docker.md) 参考安装步骤。

2. 拉取项目

```bash
git clone --depth=1 https://github.com/sohaha/zls-docker.git
```

3. 启动

*默认配置使用 nginx 与 caddy 只能启动其中一个。*

```bash
# 更多命令直接执行 run.sh 查看
./run.sh up

# Windows 请先复制配置再执行启动命令
copy .env.example .env
copy docker-compose.yml.example docker-compose.yml
docker-compose up -d nginx mysql php
```

5. 访问在浏览器中访问 http://localhost/ 。

## 配置设置

更多配置请打开 .env 文件查看。

### PHP 使用

**安装扩展**

```bash
# 编辑.env文件，
# 从扩展列表 PHP extensions 中选择相应的扩展，
# 添加（移除）到 PHP_EXTENSIONS 中，英文逗号隔开
PHP_EXTENSIONS=swoole,redis

# 重新编译 PHP 镜像并启动
./run.sh buildUp php

# Windows 请执行 docker-compose build php && docker-compose up php -d
```

### 定时任务

有些时候需要配置定时任务做一些特定业务处理，但是直接在容器内是不支持的，不过我们可以直接在宿主机上设置。

!> 请确定 crontab 下 docker-compose 能正常使用，如果不能请尝试执行 `sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose` 再试。

```bash
# 假设本脚本放在 /root/zls-docker 目录下
# 需要每分钟执行一次 www/test/task.php

# crontab -e
# 下面语句就是每分钟进入 php 容器 执行 `php test/task.php`
* * * * * /root/zls-docker/run.sh cron php php test/task.php
```

### 数据库使用

- 在其它容器需要连接数据库 HOST 直接填容器名,如使用 MySQL: mysql 即可(或 172.0.0.20)。

- 如需修改默认密码，编辑.env 文件即可，

MySQL：`MYSQL_ROOT_PASSWORD=73zls666`，

mongo：`MONGODB_INITDB_ROOT_PASSWORD=73zls666`

必须在容器生成之前，如果容器已经生成过，

请使用 bash 进入容器内修改，具体方法请谷歌。

- Msqyl 建立新数据库直接执行: `zdc mysql` 然后选 3（ Create Databases ）即可。

---

## 日常使用

### 安装脚本

建议把脚本命令安装至系统中，方便使用

```bash
./run.sh tools
# 输入1，自动安装至系统，然后就可以全局使用 zdocker

zdocker help
```

### 命令行

如要使用 composer，启动 swoole ，或 npm 安装等等。

```bash
./run.sh composer install zls/wechat
./run.sh php test.php
./run.sh npm install zls-ui
./run.sh go build
...
```

### 重新加载

nginx，php-fpm 之类的修改了配置是需要重新加载的，可使用该命令

```bash
# 不值得容器默认为nginx，下面命令等同 ./run.sh reload nginx
./run.sh reload

./run.sh reload php
```

### 进入容器

```bash
# ./run.sh bash 容器名称，如ph
./run.sh bash php
```

### 停止容器

```bash
# ./run.sh stop 容器名称（空表示停止全部）
./run.sh stop nginx
```

### 辅助操作

一些常用的操作，如 php-fpm 优化，清理没用使用的容器等等

```bash
./run.sh tools
```

### HTTPS 证书

**首次使用**

```bash
# 如果首次执行失败，建议先把签证服务修改为 letsencrypt
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
```

```bash
# ./run.sh ssl -d 要签名的域名 -w 服务器里项目访问路径
./run.sh ssl -d mydomain.com -w /home/zdocker/www/mydomain.com/public

# 证书生成成功会自动拷贝一份到 /config/nginx/conf.d/certs/mydomain.com/ 目录
# https 的配置可以参考 config/nginx/conf.d/localhost_https.conf
```

### 更多问题

**数据库安全**

默认情况数据库是禁止外部连接的，如果需要开启请修改 .env 中的 MySQL 配置，
把 `MYSQL_HOST_PORT=127.0.0.1:3306` 改成 `MYSQL_HOST_PORT=3306`

```mysql
# 为了安全性建议把 %.root 的密码修改成其他密码（默认密码：73zls666）
ALTER USER `root`@`%` IDENTIFIED BY 'xxx1990hi',`root`@`%` PASSWORD EXPIRE NEVER;
```

**数据库备份**
建议设置定时任务，定时备份数据库，如下：

```bash
# 假设本脚本放在 /root/zls-docker 目录下
# crontab -e

# 每天凌晨三点备份 MySQL 数据库
00 03 * * * /root/zls-docker/run.sh mysql backup

# 每天凌晨三点备份 MongoDB 数据库
00 03 * * * /root/zls-docker/run.sh mongodb backup

```

**MongoDB 启动失败**

```
/data/db/WiredTiger.wt: handle-open: open: Operation not permitted
```

原因: Windows 下不支持映射目录

解决方案: 注释掉 `docker-compose.yml` 文件内的 `mongodb` 映射配置，

`# - ${MONGODB_DATA_DIR}:/data/db:rw`

**Swoole 版本**

默认情况安装的是最新版的 Swoole, 如果需要指定版本直接修改安装脚本 `config/php/extensions/php.sh`

**启动失败**

查看 logs 目录，参考日志信息处理。

**安装 sentry**

首次启动之后需要初始化数据库，然后访问 http://127.0.0.1:9000 。

```bash
# 首次启动一定一定要修改 SENTRY_SECRET_KEY ，下面这条命令可以动态生成一个 SECRET_KEY
# docker run --rm sentry config generate-secret-key
# 初始化数据库，过程需要填写邮箱与密码
zdc bash sentry sentry upgrade
```

**安装 YAPI**

```bash
# 先启动 mongodb
./run.sh up mongodb

# 进入 mogodb 内 建立 Yapi 账号
./run.sh bash mongodb
# 进入 mongo 数据库
mongo -u root -p 73zls666
# 进入 Yapi 库
use yapi
# 添加一个用户 然后 Ctrl+c退出数据库 exit 退出容器
db.createUser({user: "yapi",pwd: "73zls666",roles: [{role: "dbOwner",db: "yapi"}]})
# 默认账号密码 admin@admin.com ymfe.org
# 启动 yapi (上面步骤只要执行一次)
./run.sh up yapi

```

**安装监控服务**

默认包含 grafana、prometheus、mysqlexporter。

注意: 如果你是 Root 用户启动，首次启动之前需要先给数据目录写入权限

```bash
chmod 777 ./data/grafana
chmod 777 ./data/prometheus
```

启动命令: zdc up grafana，

然后访问 http://127.0.0.1:3010/ ( 默认账号 admin/admin666 )。

配置 MySQL dashboard：

首先添加 Data Sources 选 Prometheus ,

URL填: http://prometheus:9090 ，其他的默认保存即可，

然后复制 `config/grafana/mysql-dashboard.json` 内容，贴贴到 ‘Import via panel json’ 创建完成。

如需监控服务器性能：

需手动启动（需要 docker root 权限） `zdc up nodeexporter`，再 `Import via grafana.com` 编码 8919。

zls-docker

zls-docker 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

zls-docker

zls-docker 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README