Remove blank lines after code block markers

This commit is contained in:
yeasy
2026-03-21 22:36:09 -07:00
parent 312f8fea42
commit 9ac19d79ee
132 changed files with 0 additions and 1517 deletions

View File

@@ -25,26 +25,22 @@ $ DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
$ mkdir -p $DOCKER_CONFIG/cli-plugins
$ curl -SL https://github.com/docker/compose/releases/download/v5.1.0/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose
```
之后执行
```bash
$ chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
```
### 11.2.2 测试安装
```bash
$ docker compose version
Docker Compose version v5.1.0
```
### 11.2.3 bash 补全命令
```bash
$ curl -L https://raw.githubusercontent.com/docker/compose/v5.1.0/contrib/completion/bash/docker-compose | sudo tee /etc/bash_completion.d/docker-compose > /dev/null
```
### 11.2.4 卸载
如果是二进制包方式安装的删除二进制文件即可

View File

@@ -37,7 +37,6 @@ def hello():
if __name__ == "__main__":
app.run(host="0.0.0.0", debug=True)
```
#### Dockerfile
编写 `Dockerfile` 文件内容为
@@ -49,7 +48,6 @@ WORKDIR /code
RUN pip install redis flask
CMD ["python", "app.py"]
```
#### compose.yaml
编写 `compose.yaml` 文件这是 Compose 推荐使用的主模板文件 (也兼容 `docker-compose.yml` 等历史文件名)
@@ -64,13 +62,11 @@ services:
redis:
image: "redis:alpine"
```
#### 运行 compose 项目
```bash
$ docker compose up
```
此时访问本地 `5000` 端口每次刷新页面计数就会加 1
@@ -81,13 +77,11 @@ $ docker compose up
```bash
$ docker compose up -d
```
#### 停止
```bash
$ docker compose stop
```
#### 进入服务
```bash
@@ -96,37 +90,31 @@ $ docker compose exec redis sh
127.0.0.1:6379> get hits
"9"
```
#### 查看日志
```bash
$ docker compose logs -f
```
#### 构建镜像
```bash
$ docker compose build
```
#### 启动服务
```bash
$ docker compose start
```
#### 运行一次性命令
```bash
$ docker compose run web python app.py
```
#### 验证 Compose 文件
```bash
$ docker compose config
```
#### 删除项目
```bash

View File

@@ -13,7 +13,6 @@ Docker Compose 提供了丰富的命令来管理项目和容器。本节将详
```bash
docker compose [-f=<arg>...] [options] [COMMAND] [ARGS...]
```
### 11.4.2 命令选项
* `-f, --file FILE` 指定使用的 Compose 模板文件默认会自动识别 `compose.yaml` (也兼容 `docker-compose.yml` )并且可以多次指定
@@ -75,7 +74,6 @@ docker compose [-f=<arg>...] [options] [COMMAND] [ARGS...]
```bash
$ docker compose kill -s SIGINT
```
#### `logs`
格式为 `docker compose logs [options] [SERVICE...]`
@@ -159,7 +157,6 @@ $ docker compose kill -s SIGINT
```bash
$ docker compose run ubuntu ping docker.com
```
将会启动一个 ubuntu 服务容器并执行 `ping docker.com` 命令
默认情况下如果存在关联则所有关联的服务将会自动被启动除非这些服务已经在运行中
@@ -177,7 +174,6 @@ $ docker compose run ubuntu ping docker.com
```bash
$ docker compose run --no-deps web python manage.py shell
```
将不会启动 web 容器所关联的其它容器
选项
@@ -213,7 +209,6 @@ $ docker compose run --no-deps web python manage.py shell
```bash
$ docker compose scale web=3 db=2
```
将启动 3 个容器运行 web 服务2 个容器运行 db 服务
> **提示**部分版本的 Compose 可能不再提供独立的 `scale` 子命令 (或不推荐使用)此时可使用 `docker compose up` `--scale` 选项达到同样效果
@@ -316,7 +311,6 @@ services:
- action: rebuild
path: package.json
```
选项
* `--no-up` 不自动启动服务

View File

@@ -13,7 +13,6 @@ services:
volumes:
- "/data"
```
注意每个服务都必须通过 `image` 指令指定镜像或 `build` 指令 (需要 Dockerfile) 等来自动构建生成镜像
如果使用 `build` 指令 `Dockerfile` 中设置的选项 (例如`CMD``EXPOSE``VOLUME``ENV` ) 将会自动被获取无需在 Compose 文件中重复设置
@@ -29,7 +28,6 @@ services:
webapp:
build: ./dir
```
你也可以使用 `context` 指令指定 `Dockerfile` 所在文件夹的路径
使用 `dockerfile` 指令指定 `Dockerfile` 文件名
@@ -45,7 +43,6 @@ services:
args:
buildno: 1
```
使用 `cache_from` 指定构建镜像的缓存
```yaml
@@ -55,7 +52,6 @@ build:
- alpine:latest
- corp/web_app:3.14
```
### 11.5.2 `cap_add, cap_drop`
指定容器的内核能力 (capacity) 分配
@@ -66,14 +62,12 @@ build:
cap_add:
- ALL
```
去掉 NET_ADMIN 能力可以指定为
```yaml
cap_drop:
- NET_ADMIN
```
### 11.5.3 `command`
覆盖容器启动后默认执行的命令
@@ -81,7 +75,6 @@ cap_drop:
```yaml
command: echo "hello world"
```
### 11.5.4 `configs`
`configs` 来自 Compose Specification它在 Swarm 中是原生对象在本地 `docker compose` 模式下通常以文件挂载的形式实现具体能力取决于 Compose 版本与运行平台
@@ -95,7 +88,6 @@ command: echo "hello world"
```yaml
cgroup_parent: cgroups_1
```
### 11.5.6 `container_name`
指定容器名称默认将会使用 `项目名称_服务名称_序号` 这样的格式
@@ -103,7 +95,6 @@ cgroup_parent: cgroups_1
```yaml
container_name: docker-web-container
```
> 注意指定容器名称后该服务将无法进行扩展 (scale)因为 Docker 不允许多个容器具有相同的名称
### 11.5.7 `deploy`
@@ -118,7 +109,6 @@ container_name: docker-web-container
devices:
- "/dev/ttyUSB1:/dev/ttyUSB0"
```
### 11.5.9 `depends_on`
解决容器的依赖启动先后的问题以下例子中会先启动 `redis` `db` 再启动 `web`
@@ -137,7 +127,6 @@ services:
db:
image: postgres
```
> 注意`web` 服务不会等待 `redis` `db` 完全启动 之后才启动
### 11.5.10 `dns`
@@ -151,7 +140,6 @@ dns:
- 8.8.8.8
- 114.114.114.114
```
### 11.5.11 `dns_search`
配置 `DNS` 搜索域可以是一个值也可以是一个列表
@@ -163,7 +151,6 @@ dns_search:
- domain1.example.com
- domain2.example.com
```
### 11.5.12 `tmpfs`
挂载一个 tmpfs 文件系统到容器
@@ -174,7 +161,6 @@ tmpfs:
- /run
- /tmp
```
### 11.5.13 `env_file`
从文件中获取环境变量可以为单独的文件路径或列表
@@ -191,16 +177,13 @@ env_file:
- ./apps/web.env
- /opt/secrets.env
```
环境变量文件中每一行必须符合格式支持 `#` 开头的注释行
```bash
## common.env: Set development environment
PROG_ENV=development
```
### 11.5.14 `environment`
设置环境变量你可以使用数组或字典两种格式
@@ -216,13 +199,11 @@ environment:
- RACK_ENV=development
- SESSION_SECRET
```
如果变量名称或者值中用到 `true|falseyes|no` 等表达[布尔](https://yaml.org/type/bool.html)含义的词汇,最好放到引号里,避免 YAML 自动解析某些内容为对应的布尔语义。这些特定词汇,包括
```bash
y|Y|yes|Yes|YES|n|N|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF
```
### 11.5.15 `expose`
暴露端口但不映射到宿主机只被连接的服务访问
@@ -234,7 +215,6 @@ expose:
- "3000"
- "8000"
```
### 11.5.16 `external_links`
> 注意不建议使用该指令
@@ -247,7 +227,6 @@ external_links:
- project_db_1:mysql
- project_db_1:postgresql
```
### 11.5.17 `extra_hosts`
类似 Docker 中的 `--add-host` 参数指定额外的 host 名称映射信息
@@ -257,14 +236,12 @@ extra_hosts:
- "googledns:8.8.8.8"
- "dockerhub:52.1.157.61"
```
会在启动后的服务容器中 `/etc/hosts` 文件中添加如下两条条目
```bash
8.8.8.8 googledns
52.1.157.61 dockerhub
```
### 11.5.18 `healthcheck`
通过命令检查容器是否健康运行
@@ -276,7 +253,6 @@ healthcheck:
timeout: 10s
retries: 3
```
### 11.5.19 `image`
指定为镜像名称或镜像 ID如果镜像在本地不存在`Compose` 将会尝试拉取这个镜像
@@ -286,7 +262,6 @@ image: ubuntu
image: orchardup/postgresql
image: a4bc65fd
```
### 11.5.20 `labels`
为容器添加 Docker 元数据 (metadata) 信息例如可以为容器添加辅助说明信息
@@ -297,7 +272,6 @@ labels:
com.startupteam.department: "devops department"
com.startupteam.release: "rc3 for v1.0"
```
### 11.5.21 `links`
> 注意不推荐使用该指令容器之间应通过 Docker 网络 (networks) 进行互联
@@ -312,7 +286,6 @@ logging:
options:
syslog-address: "tcp://192.168.0.42:123"
```
目前支持三种日志驱动类型
```yaml
@@ -320,7 +293,6 @@ driver: "json-file"
driver: "syslog"
driver: "none"
```
`options` 配置日志驱动的相关参数
```yaml
@@ -328,7 +300,6 @@ options:
max-size: "200k"
max-file: "10"
```
### 11.5.23 `network_mode`
设置网络模式使用和 `docker run` `--network` 参数一样的值
@@ -340,13 +311,11 @@ network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"
```
### 11.5.24 `networks`
配置容器连接的网络
```yaml
services:
some-service:
@@ -358,7 +327,6 @@ networks:
some-network:
other-network:
```
### 11.5.25 `pid`
跟主机系统共享进程命名空间打开该选项的容器之间以及容器和宿主机系统之间可以通过进程 ID 来相互访问和操作
@@ -366,7 +334,6 @@ networks:
```yaml
pid: "host"
```
### 11.5.26 `ports`
暴露端口信息
@@ -380,7 +347,6 @@ ports:
- "49100:22"
- "127.0.0.1:8001:8001"
```
*注意当使用 `HOST:CONTAINER` 格式来映射端口时如果你使用的容器端口小于 60 并且没放到引号里可能会得到错误结果因为 `YAML` 会自动解析 `xx:yy` 这种数字格式为 60 进制为避免出现这种问题建议数字串都采用引号包括起来的字符串格式*
### 11.5.27 `secrets`
@@ -388,7 +354,6 @@ ports:
存储敏感数据例如 `mysql` 服务密码
```yaml
services:
mysql:
@@ -405,7 +370,6 @@ secrets:
my_other_secret:
external: true
```
### 11.5.28 `security_opt`
指定容器模板标签 (label) 机制的默认属性 (用户角色类型级别等)例如配置标签的用户名和角色名
@@ -415,7 +379,6 @@ security_opt:
- label:user:USER
- label:role:ROLE
```
### 11.5.29 `stop_signal`
设置另一个信号来停止容器在默认情况下使用的是 SIGTERM 停止容器
@@ -423,7 +386,6 @@ security_opt:
```yaml
stop_signal: SIGUSR1
```
### 11.5.30 `sysctls`
配置容器内核参数
@@ -437,7 +399,6 @@ sysctls:
- net.core.somaxconn=1024
- net.ipv4.tcp_syncookies=0
```
### 11.5.31 `ulimits`
指定容器的 ulimits 限制值
@@ -451,7 +412,6 @@ sysctls:
soft: 20000
hard: 40000
```
### 11.5.32 `volumes`
数据卷所挂载路径设置可以设置为宿主机路径 (`HOST:CONTAINER`) 或者数据卷名称 (`VOLUME:CONTAINER`)并且可以设置访问模式 (`HOST:CONTAINER:ro`)
@@ -464,7 +424,6 @@ volumes:
- cache/:/tmp/cache
- ~/configs:/etc/configs/:ro
```
如果路径为数据卷名称必须在文件中配置数据卷
```yaml
@@ -477,7 +436,6 @@ services:
volumes:
mysql_data:
```
### 11.5.33 其它指令
此外还有包括 `domainname, entrypoint, hostname, ipc, mac_address, privileged, read_only, shm_size, restart, stdin_open, tty, user, working_dir` 等指令基本跟 `docker run` 中对应参数的功能一致
@@ -487,19 +445,16 @@ volumes:
```yaml
entrypoint: /code/entrypoint.sh
```
指定容器中运行应用的用户名
```yaml
user: nginx
```
指定容器中工作目录
```yaml
working_dir: /code
```
指定容器中搜索域名主机名mac 地址等
```yaml
@@ -507,37 +462,31 @@ domainname: your_website.com
hostname: test
mac_address: 08-00-27-00-0C-0A
```
允许容器中运行一些特权命令
```yaml
privileged: true
```
指定容器退出后的重启策略为始终重启该命令对保持服务始终运行十分有效在生产环境中推荐配置为 `always` 或者 `unless-stopped`
```yaml
restart: always
```
以只读模式挂载容器的 root 文件系统意味着不能对容器内容进行修改
```yaml
read_only: true
```
打开标准输入可以接受外部输入
```yaml
stdin_open: true
```
模拟一个伪终端
```yaml
tty: true
```
### 11.5.34 读取变量
Compose 模板文件支持动态读取主机的系统环境变量和当前目录下的 `.env` 文件中的变量
@@ -545,13 +494,11 @@ Compose 模板文件支持动态读取主机的系统环境变量和当前目录
例如下面的 Compose 文件将从运行它的环境中读取变量 `${MONGO_VERSION}` 的值并写入执行的指令中
```yaml
services:
db:
image: "mongo:${MONGO_VERSION}"
```
如果执行 `MONGO_VERSION=3.2 docker compose up` 则会启动一个 `mongo:3.2` 镜像的容器如果执行 `MONGO_VERSION=2.8 docker compose up` 则会启动一个 `mongo:2.8` 镜像的容器
若当前目录存在 `.env` 文件执行 `docker compose` 命令时将从该文件中读取变量
@@ -559,10 +506,8 @@ db:
在当前目录新建 `.env` 文件并写入以下内容
```bash
## 支持 # 号注释
MONGO_VERSION=3.6
```
执行 `docker compose up` 则会启动一个 `mongo:3.6` 镜像的容器

View File

@@ -30,7 +30,6 @@ flowchart TD
Browser["localhost:8000<br/>(浏览器访问)"]
Port8000 --> Browser
```
11-1Django + PostgreSQL Compose 架构
**关键点**
@@ -47,7 +46,6 @@ flowchart TD
```bash
$ mkdir django-docker && cd django-docker
```
我们需要创建三个文件`Dockerfile``requirements.txt` `compose.yaml`
### 11.6.3 步骤 1创建 Dockerfile
@@ -75,7 +73,6 @@ RUN pip install --no-cache-dir -r requirements.txt
COPY . /code/
```
**逐行解释**
| 指令 | 作用 | 为什么这样写 |
@@ -95,7 +92,6 @@ Django>=5.0,<6.0
psycopg[binary]>=3.1,<4.0
gunicorn>=21.0,<22.0
```
**依赖说明**
| 包名 | 作用 |
@@ -140,7 +136,6 @@ services:
volumes:
postgres_data:
```
**配置详解**
#### db 服务
@@ -160,7 +155,6 @@ db:
test: ["CMD-SHELL", "pg_isready -U django_user -d django_db"]
interval: 5s
```
> **笔者提醒**`volumes` 配置很重要没有它每次容器重启数据都会丢失笔者见过不少新手因为忘记这一步导致开发数据全部丢失
#### web 服务
@@ -179,7 +173,6 @@ web:
db:
condition: service_healthy # 等待数据库健康后再启动
```
**关键配置说明**
| 配置项 | 作用 | 笔者建议 |
@@ -195,7 +188,6 @@ web:
```bash
$ docker compose run --rm web django-admin startproject mysite .
```
**命令解释**
- `docker compose run`运行一次性命令
@@ -218,7 +210,6 @@ django-docker/
├── asgi.py
└── wsgi.py
```
> 💡 **Linux 用户注意**如果遇到权限问题执行 `sudo chown -R $USER:$USER .`
### 11.6.7 步骤 5配置数据库连接
@@ -243,7 +234,6 @@ DATABASES = {
ALLOWED_HOSTS = ['*']
```
**为什么 HOST `db` 而不是 `localhost`**
Docker Compose 各服务通过服务名相互访问Docker 内置的 DNS 会将 `db` 解析为 db 服务容器的 IP 地址这是 Docker Compose 的核心功能之一
@@ -253,7 +243,6 @@ ALLOWED_HOSTS = ['*']
```bash
$ docker compose up
```
你会看到
1. 首先构建 web 镜像 (第一次运行)
@@ -266,7 +255,6 @@ db-1 | LOG: database system is ready to accept connections
web-1 | Watching for file changes with StatReloader
web-1 | Starting development server at http://0.0.0.0:8000/
```
打开浏览器访问 `http://localhost:8000`可以看到 Django 欢迎页面
### 11.6.9 常用开发命令
@@ -274,7 +262,6 @@ web-1 | Starting development server at http://0.0.0.0:8000/
在另一个终端窗口执行
```bash
## 执行数据库迁移
$ docker compose exec web python manage.py migrate
@@ -291,7 +278,6 @@ $ docker compose exec web python manage.py shell
$ docker compose exec db psql -U django_user -d django_db
```
> 💡 笔者建议使用 `exec` 而不是 `run``exec` 在已运行的容器中执行命令`run` 会创建新容器
### 11.6.10 常见问题排查
@@ -307,13 +293,11 @@ $ docker compose exec db psql -U django_user -d django_db
| 网络未创建 | 运行 `docker compose down` 后重新 `up` |
```bash
## 调试:检查数据库是否正常运行
$ docker compose ps
$ docker compose logs db
```
#### Q2代码修改没有生效
**可能原因**
@@ -325,12 +309,10 @@ $ docker compose logs db
#### Q3权限问题
```bash
## 如果容器内创建的文件 root 用户所有
$ sudo chown -R $USER:$USER .
```
### 11.6.11 开发 vs 生产关键差异
笔者特别提醒本节的配置是 **开发环境** 配置生产环境需要以下调整
@@ -344,7 +326,6 @@ $ sudo chown -R $USER:$USER .
| **ALLOWED_HOSTS**| `['*']` | 具体域名 |**生产环境 Compose 文件示例**
```yaml
## compose.prod.yaml
services:
@@ -359,7 +340,6 @@ services:
# ...
```
### 11.6.12 延伸阅读
- [Compose 模板文件详解](11.5_compose_file.md)深入理解 Compose 文件的所有配置项

View File

@@ -30,7 +30,6 @@ flowchart TD
Browser["localhost:3000"]
Port3000 --> Browser
```
11-2Rails + PostgreSQL Compose 架构
### 11.7.2 准备工作
@@ -40,7 +39,6 @@ flowchart TD
```bash
$ mkdir rails-docker && cd rails-docker
```
需要创建三个文件`Dockerfile``Gemfile` `compose.yaml`
### 11.7.3 步骤 1创建 Dockerfile
@@ -68,7 +66,6 @@ RUN bundle install
COPY . /myapp
```
**配置说明**
| 指令 | 作用 |
@@ -86,13 +83,11 @@ COPY . /myapp
source 'https://rubygems.org'
gem 'rails', '~> 7.1'
```
创建空的 `Gemfile.lock`
```bash
$ touch Gemfile.lock
```
### 11.7.5 步骤 3创建 compose.yaml
配置如下
@@ -121,7 +116,6 @@ services:
volumes:
postgres_data:
```
**配置详解**
| 配置项 | 说明 |
@@ -138,7 +132,6 @@ volumes:
```bash
$ docker compose run --rm web rails new . --force --database=postgresql --skip-bundle
```
**命令解释**
- `--rm`执行后删除临时容器
@@ -155,7 +148,6 @@ Gemfile.lock README.md app config.ru log
compose.yaml bin db public
```
> **Linux 用户**如遇权限问题执行 `sudo chown -R $USER:$USER .`
### 11.7.7 步骤 5重新构建镜像
@@ -165,7 +157,6 @@ compose.yaml bin db public
```bash
$ docker compose build
```
### 11.7.8 步骤 6配置数据库连接
修改 `config/database.yml`
@@ -187,7 +178,6 @@ test:
production:
<<: *default
```
> 💡 使用 `DATABASE_URL` 环境变量配置数据库符合 12-factor 应用原则便于在不同环境间切换
### 11.7.9 步骤 7启动应用
@@ -195,7 +185,6 @@ production:
```bash
$ docker compose up
```
输出示例
```bash
@@ -207,7 +196,6 @@ web-1 | => Run `bin/rails server --help` for more startup options
web-1 | Puma starting in single mode...
web-1 | * Listening on http://0.0.0.0:3000
```
### 11.7.10 步骤 8创建数据库
在另一个终端执行
@@ -217,13 +205,11 @@ $ docker compose exec web rails db:create
Created database 'myapp_development'
Created database 'myapp_test'
```
访问 http://localhost:3000 查看 Rails 欢迎页面。
### 11.7.11 常用开发命令
```bash
## 数据库迁移
$ docker compose exec web rails db:migrate
@@ -244,7 +230,6 @@ $ docker compose exec web rails generate scaffold Post title:string body:text
$ docker compose exec web bash
```
### 11.7.12 常见问题
#### Q数据库连接失败
@@ -255,7 +240,6 @@ $ docker compose exec web bash
$ docker compose ps
$ docker compose logs db
```
#### Qserver.pid 文件导致启动失败
错误信息`A server is already running`
@@ -265,7 +249,6 @@ $ docker compose logs db
```bash
$ docker compose exec web rm -f tmp/pids/server.pid
```
#### QGem 安装失败
可能需要更新 bundler 或清理缓存
@@ -273,7 +256,6 @@ $ docker compose exec web rm -f tmp/pids/server.pid
```bash
$ docker compose run --rm web bundle update
```
### 11.7.13 开发 vs 生产
| 配置项 | 开发环境 | 生产环境 |

View File

@@ -13,7 +13,6 @@ wordpress/
└── nginx/ # 可选:反向代理配置
└── nginx.conf
```
---
### 11.8.2 编写 `compose.yaml`
@@ -74,7 +73,6 @@ volumes:
networks:
wp_net:
```
---
### 11.8.3 配置文件详解
@@ -87,7 +85,6 @@ networks:
DB_ROOT_PASSWORD=somestrongrootpassword
DB_PASSWORD=somestronguserpassword
```
Compose 会自动读取此同级目录下的文件
#### 2. 数据持久化
@@ -108,7 +105,6 @@ upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 600
```
---
### 11.8.4 启动与运行
@@ -118,7 +114,6 @@ max_execution_time = 600
```bash
$ docker compose up -d
```
2. 访问安装界面
打开浏览器访问 `http://localhost:8000`
@@ -127,7 +122,6 @@ $ docker compose up -d
```bash
$ docker compose logs -f
```
---
### 11.8.5 生产环境最佳实践
@@ -137,12 +131,10 @@ $ docker compose logs -f
不要只依赖 Volume建议定期备份数据库
```bash
## 导出 SQL
$ docker exec wordpress_db mysqldump -u wordpress -pwordpress wordpress > backup.sql
```
或者添加一个自动备份容器
```yaml
@@ -162,7 +154,6 @@ $ docker exec wordpress_db mysqldump -u wordpress -pwordpress wordpress > backup
networks:
- wp_net
```
#### 2. 使用 Nginx 反向代理
在生产环境中不要直接暴露 WordPress 端口而是通过 Nginx 进行反向代理并配置 SSL
@@ -178,7 +169,6 @@ WordPress 支持 Redis 缓存以提高性能。
networks:
- wp_net
```
WordPress 容器环境变量中添加
```yaml
WORDPRESS_REDIS_HOST: redis
@@ -204,7 +194,6 @@ WordPress 支持 Redis 缓存以提高性能。
```bash
$ docker compose restart wordpress
```
---
### 11.8.7 延伸阅读