|
|
@@
-0,0
+1,450
|
|
|
|
1
|
## 介绍
|
|
|
|
2
|
`rpi23-gen-image.sh` 是一个自动生成树莓派2/3系统镜像的脚本工具, 当前支持自动生成32位 armhf 架构的Debian, 发行版本`jessie`, `stretch` 和 `buster`. 树莓派3 64位镜像需要使用特定的配置参数 (```templates/rpi3-stretch-arm64-4.11.y```).
|
|
|
|
3
|
|
|
|
|
4
|
## 构建环境所依赖的包
|
|
|
|
5
|
一定要安装好下列deb包, 他们是构建过程需要的核心包. 脚本会自动检查, 如果缺少,经用户确认后会自动安装.
|
|
|
|
6
|
|
|
|
|
7
|
```debootstrap debian-archive-keyring qemu-user-static binfmt-support dosfstools rsync bmap-tools whois git bc psmisc dbus sudo```
|
|
|
|
8
|
|
|
|
|
9
|
推荐通过配置 `rpi23-gen-image.sh` 脚本编译安装最新的树莓派 Linux 内核, 对于树莓派3, 只能如此. 在构建系统上使用 ARM (armhf) 交叉编译工具链编译内核.
|
|
|
|
10
|
|
|
|
|
11
|
脚本已经在Debian Liux `jessie` 和`stretch` 构建系统下使用默认的 `crossbuild-essential-armhf` 工具链进行过测试. 获取更多信息请查看 [Debian 交叉工具链 Wiki](https://wiki.debian.org/CrossToolchains) .
|
|
|
|
12
|
|
|
|
|
13
|
如果使用Debian Linux `jessie` 构建系统, 先要添加交叉编译工具链的源 [Debian 交叉工具链仓库](http://emdebian.org/tools/debian/):
|
|
|
|
14
|
|
|
|
|
15
|
```
|
|
|
|
16
|
echo "deb http://emdebian.org/tools/debian/ jessie main" > /etc/apt/sources.list.d/crosstools.list
|
|
|
|
17
|
sudo -u nobody wget -O - http://emdebian.org/tools/debian/emdebian-toolchain-archive.key | apt-key add -
|
|
|
|
18
|
dpkg --add-architecture armhf
|
|
|
|
19
|
apt-get update
|
|
|
|
20
|
```
|
|
|
|
21
|
|
|
|
|
22
|
## 命令行参数
|
|
|
|
23
|
脚本可以使用特定的命令行参数来允许或禁止操作系统的某些特性、服务和配置信息. 这些参数通过（简单）脚本变量传递给 `rpi23-gen-image.sh`. 不同于环境变量, （简单）脚本变量在调用`rpi23-gen-image.sh`的命令行前面定义.
|
|
|
|
24
|
|
|
|
|
25
|
##### 命令行示例:
|
|
|
|
26
|
```shell
|
|
|
|
27
|
ENABLE_UBOOT=true ./rpi23-gen-image.sh
|
|
|
|
28
|
ENABLE_CONSOLE=false ENABLE_IPV6=false ./rpi23-gen-image.sh
|
|
|
|
29
|
ENABLE_WM=xfce4 ENABLE_FBTURBO=true ENABLE_MINBASE=true ./rpi23-gen-image.sh
|
|
|
|
30
|
ENABLE_HARDNET=true ENABLE_IPTABLES=true /rpi23-gen-image.sh
|
|
|
|
31
|
APT_SERVER=ftp.de.debian.org APT_PROXY="http://127.0.0.1:3142/" ./rpi23-gen-image.sh
|
|
|
|
32
|
ENABLE_MINBASE=true ./rpi23-gen-image.sh
|
|
|
|
33
|
BUILD_KERNEL=true ENABLE_MINBASE=true ENABLE_IPV6=false ./rpi23-gen-image.sh
|
|
|
|
34
|
BUILD_KERNEL=true KERNELSRC_DIR=/tmp/linux ./rpi23-gen-image.sh
|
|
|
|
35
|
ENABLE_MINBASE=true ENABLE_REDUCE=true ENABLE_MINGPU=true BUILD_KERNEL=true ./rpi23-gen-image.sh
|
|
|
|
36
|
ENABLE_CRYPTFS=true CRYPTFS_PASSWORD=changeme EXPANDROOT=false ENABLE_MINBASE=true ENABLE_REDUCE=true ENABLE_MINGPU=true BUILD_KERNEL=true ./rpi23-gen-image.sh
|
|
|
|
37
|
RELEASE=stretch BUILD_KERNEL=true ./rpi23-gen-image.sh
|
|
|
|
38
|
RPI_MODEL=3 ENABLE_WIRELESS=true ENABLE_MINBASE=true BUILD_KERNEL=true ./rpi23-gen-image.sh
|
|
|
|
39
|
RELEASE=stretch RPI_MODEL=3 ENABLE_WIRELESS=true ENABLE_MINBASE=true BUILD_KERNEL=true ./rpi23-gen-image.sh
|
|
|
|
40
|
```
|
|
|
|
41
|
|
|
|
|
42
|
## 参数模板文件
|
|
|
|
43
|
为了避免冗长的命令行参数以及存储感兴趣的参数配置, `rpi23-gen-image.sh` 支持所谓的参数模板文件 (`CONFIG_TEMPLATE`=template). 这些文本文件位于 `./templates` 目录, 文件中含有将会使用的配置参数. 新的配置模板文件会被添加到 `./templates` 目录.
|
|
|
|
44
|
|
|
|
|
45
|
##### 命令行示例:
|
|
|
|
46
|
```shell
|
|
|
|
47
|
CONFIG_TEMPLATE=rpi3stretch ./rpi23-gen-image.sh
|
|
|
|
48
|
CONFIG_TEMPLATE=rpi2stretch ./rpi23-gen-image.sh
|
|
|
|
49
|
```
|
|
|
|
50
|
|
|
|
|
51
|
## 支持的参数和设置
|
|
|
|
52
|
#### APT 设置:
|
|
|
|
53
|
##### `APT_SERVER`="ftp.debian.org"
|
|
|
|
54
|
设置 Debian 仓库地址. 选择一个 [镜像站点](https://www.debian.org/mirror/list). 选一个近的镜像站点会加快镜像生成过程中所需文件的下载速度.
|
|
|
|
55
|
|
|
|
|
56
|
##### `APT_PROXY`=""
|
|
|
|
57
|
设置代理服务器地址. 使用本地缓存代理, 比如 `apt-cacher-ng` 可以缩短镜像生成时间, 因为所需要的 Debian 包文件只需下载一次.
|
|
|
|
58
|
|
|
|
|
59
|
##### `APT_INCLUDES`=""
|
|
|
|
60
|
生成镜像过程中最先由debootstrap程序自动安装的附加包, 逗号分隔.
|
|
|
|
61
|
|
|
|
|
62
|
##### `APT_INCLUDES_LATE`=""
|
|
|
|
63
|
生成镜像过程中最初的debootstrap完成后, 需要的使用apt命令安装的附加包, 逗号分隔. 特别用在含有 pre-depend 依赖关系的包的, 其依赖关系在打包过程中debootstrap程序中无法正确处理.
|
|
|
|
64
|
|
|
|
|
65
|
---
|
|
|
|
66
|
|
|
|
|
67
|
#### 通用系统设置:
|
|
|
|
68
|
##### `RPI_MODEL`=2
|
|
|
|
69
|
指定树莓派型号. 当前支持树莓派 `2` 和 `3`. 设为 `3` 时 `BUILD_KERNEL` 自动设为true .
|
|
|
|
70
|
|
|
|
|
71
|
##### `RELEASE`="jessie"
|
|
|
|
72
|
设置 Debian 发行版. 脚本当前支持 Debian 发行版 "jessie", "stretch" 和 "buster" 的自动生成. 设为`stretch` 或 `buster`时 `BUILD_KERNEL` 自动设为true.
|
|
|
|
73
|
|
|
|
|
74
|
##### `RELEASE_ARCH`="armhf"
|
|
|
|
75
|
设置期望的 Debian 发行架构.
|
|
|
|
76
|
|
|
|
|
77
|
##### `HOSTNAME`="rpi$RPI_MODEL-$RELEASE"
|
|
|
|
78
|
设置主机名称. 建议所在的子网中主机名称是唯一的.
|
|
|
|
79
|
|
|
|
|
80
|
##### `PASSWORD`="raspberry"
|
|
|
|
81
|
设置系统的 `root` 用户密码. **强烈**建议选择一个自定义密码 .
|
|
|
|
82
|
|
|
|
|
83
|
##### `USER_PASSWORD`="raspberry"
|
|
|
|
84
|
设置由 `USER_NAME`=pi 参数创建的普通用户的密码. 如果 `ENABLE_USER`=false 则忽略. **强烈**建议选择一个自定义密码.
|
|
|
|
85
|
|
|
|
|
86
|
##### `DEFLOCAL`="en_US.UTF-8"
|
|
|
|
87
|
设置系统默认 locale. 将来可以在运行的系统中执行 `dpkg-reconfigure locales` 命令更改此项设置. 设置这项脚本会自动安装 `locales`, `keyboard-configuration` 和 `console-setup` 三个包.
|
|
|
|
88
|
|
|
|
|
89
|
##### `TIMEZONE`="Europe/Berlin"
|
|
|
|
90
|
设置系统默认时区. 可以在`/usr/share/zoneinfo/` 目录中找到全部可用时区. 将来可以在运行的系统中执行 `dpkg-reconfigure tzdata` 命令更改此项设置.
|
|
|
|
91
|
|
|
|
|
92
|
##### `EXPANDROOT`=true
|
|
|
|
93
|
第一次运行时自动扩展根分区和文件系统.
|
|
|
|
94
|
|
|
|
|
95
|
---
|
|
|
|
96
|
|
|
|
|
97
|
#### 键盘设置:
|
|
|
|
98
|
这些选项用来配置键盘布局文件 `/etc/default/keyboard` 影响控制台和X窗口. 将来可以在运行的系统中执行 `dpkg-reconfigure keyboard-configuration` 命令更改此项设置.
|
|
|
|
99
|
|
|
|
|
100
|
##### `XKB_MODEL`=""
|
|
|
|
101
|
设置键盘类型, 大陆常见pc104.
|
|
|
|
102
|
|
|
|
|
103
|
##### `XKB_LAYOUT`=""
|
|
|
|
104
|
设置键盘布局, 大陆常见us.
|
|
|
|
105
|
|
|
|
|
106
|
##### `XKB_VARIANT`=""
|
|
|
|
107
|
设置键盘布局变种.
|
|
|
|
108
|
|
|
|
|
109
|
##### `XKB_OPTIONS`=""
|
|
|
|
110
|
设置其它 XKB 配置选项.
|
|
|
|
111
|
|
|
|
|
112
|
---
|
|
|
|
113
|
|
|
|
|
114
|
#### 网络设置 (动态):
|
|
|
|
115
|
设置网络为自动获取IP地址. 配置文件位于 `/etc/systemd/network/eth.network`. 在Debian `stretch`中, 默认位置更改为 `/lib/systemd/network`.
|
|
|
|
116
|
|
|
|
|
117
|
##### `ENABLE_DHCP`=true
|
|
|
|
118
|
设置系统使用 DHCP 获取动态IP. 需要有一个 DHCP 服务器.
|
|
|
|
119
|
|
|
|
|
120
|
---
|
|
|
|
121
|
|
|
|
|
122
|
#### 网络设置 (静态):
|
|
|
|
123
|
设置系统为手动配置IP地址. 配置文件位于 `/etc/systemd/network/eth.network`. 在Debian `stretch` 中, 默认位置更改为 `/lib/systemd/network`.
|
|
|
|
124
|
当 `ENABLE_DHCP`=false 时下面这些静态IP设置才起作用.
|
|
|
|
125
|
|
|
|
|
126
|
##### `NET_ADDRESS`=""
|
|
|
|
127
|
设置静态 IPv4 或 IPv6, 使用CIDR "/"形式, 如 "192.169.0.3/24".
|
|
|
|
128
|
|
|
|
|
129
|
##### `NET_GATEWAY`=""
|
|
|
|
130
|
设置默认网关的地址.
|
|
|
|
131
|
|
|
|
|
132
|
##### `NET_DNS_1`=""
|
|
|
|
133
|
设置主域名服务器地址.
|
|
|
|
134
|
|
|
|
|
135
|
##### `NET_DNS_2`=""
|
|
|
|
136
|
设置辅域名服务器地址.
|
|
|
|
137
|
|
|
|
|
138
|
##### `NET_DNS_DOMAINS`=""
|
|
|
|
139
|
设置默认的域名搜索后缀, 当主机名称不是一个完整域名(FQDN)时使用.
|
|
|
|
140
|
|
|
|
|
141
|
##### `NET_NTP_1`=""
|
|
|
|
142
|
设置主时间服务器地址.
|
|
|
|
143
|
|
|
|
|
144
|
##### `NET_NTP_2`=""
|
|
|
|
145
|
设置辅时间服务器地址.
|
|
|
|
146
|
|
|
|
|
147
|
---
|
|
|
|
148
|
|
|
|
|
149
|
#### 基本系统特性:
|
|
|
|
150
|
##### `ENABLE_CONSOLE`=true
|
|
|
|
151
|
允许串行控制台接口. 没有连接显示器键盘的树莓派推荐打开, 此时如果网络无法连接至树莓派, 可以使用串行控制台连至系统.
|
|
|
|
152
|
|
|
|
|
153
|
##### `ENABLE_I2C`=false
|
|
|
|
154
|
允许树莓派2/3的 I2C 接口. 请对照 [树莓派2/3 引脚示意图](http://elinux.org/RPi_Low-level_peripherals) 正确连接 GPIO 引脚.
|
|
|
|
155
|
|
|
|
|
156
|
##### `ENABLE_SPI`=false
|
|
|
|
157
|
允许树莓派2/3的 SPI 接口. 请对照 [树莓派2/3 引脚示意图](http://elinux.org/RPi_Low-level_peripherals) 正确连接 GPIO 引脚.
|
|
|
|
158
|
|
|
|
|
159
|
##### `ENABLE_IPV6`=true
|
|
|
|
160
|
允许 IPv6 . 通过 systemd-networkd 配置管理网络接口.
|
|
|
|
161
|
|
|
|
|
162
|
##### `ENABLE_SSHD`=true
|
|
|
|
163
|
安装并且允许 OpenSSH 服务. 此服务默认禁止 `root` 用户远程登录. 使用普通用户 `pi` 远程登录然后使用 `su -` 或 `sudo` 来取得root权限.
|
|
|
|
164
|
|
|
|
|
165
|
##### `ENABLE_NONFREE`=false
|
|
|
|
166
|
允许安装仓库中的 non-free 类的软件包. 需要安装闭源的固件, 二进制大对象 blob.
|
|
|
|
167
|
|
|
|
|
168
|
##### `ENABLE_WIRELESS`=false
|
|
|
|
169
|
下载安装树莓派3无线接口所需要的闭源固件 二进制blob [树莓派3无线接口固件](https://github.com/RPi-Distro/firmware-nonfree/tree/master/brcm80211/brcm). 如果 `RPI_MODEL` 不是 `3` 则忽略.
|
|
|
|
170
|
|
|
|
|
171
|
##### `ENABLE_RSYSLOG`=true
|
|
|
|
172
|
如果设置为 false, 禁用并卸载 rsyslog, 则只能通过日志文件查看logs.
|
|
|
|
173
|
|
|
|
|
174
|
##### `ENABLE_SOUND`=true
|
|
|
|
175
|
允许声卡并且安装 ALSA.
|
|
|
|
176
|
|
|
|
|
177
|
##### `ENABLE_HWRANDOM`=true
|
|
|
|
178
|
允许硬件随机数发生器. 强随机数对大多数使用加密的网络通信是非常重要的. 推荐允许此设置.
|
|
|
|
179
|
|
|
|
|
180
|
##### `ENABLE_MINGPU`=false
|
|
|
|
181
|
最小化显存 (16MB, no X), 目前无法完全禁用GPU.
|
|
|
|
182
|
|
|
|
|
183
|
##### `ENABLE_DBUS`=true
|
|
|
|
184
|
安装并允许 D-Bus 消息总线. 虽然 systemd 可以在没有 D-bus的情况下工作, 但是推荐允许D-Bus.
|
|
|
|
185
|
|
|
|
|
186
|
##### `ENABLE_XORG`=false
|
|
|
|
187
|
是否安装 Xorg, 开源 X11 系统.
|
|
|
|
188
|
|
|
|
|
189
|
##### `ENABLE_WM`=""
|
|
|
|
190
|
安装用户指定的X Window 窗口管理器. 如果设置了`ENABLE_WM`, 系统确定所有被依赖的X11相关软件包都安装好了以后`ENABLE_XORG`会自动设置为true, `rpi23-gen-image.sh` 脚本已经通过下列窗口管理器的测试: `blackbox`, `openbox`, `fluxbox`, `jwm`, `dwm`, `xfce4`, `awesome`.
|
|
|
|
191
|
|
|
|
|
192
|
---
|
|
|
|
193
|
|
|
|
|
194
|
#### 高级系统特性:
|
|
|
|
195
|
##### `ENABLE_MINBASE`=false
|
|
|
|
196
|
使用 debootstrap 脚本变量 `minbase`, 只含有必不可少的核心包和apt. 体积大约 65 MB.
|
|
|
|
197
|
|
|
|
|
198
|
##### `ENABLE_REDUCE`=false
|
|
|
|
199
|
卸载包、删除文件以减小体积 详情查看 `REDUCE_*` 参数.
|
|
|
|
200
|
|
|
|
|
201
|
##### `ENABLE_UBOOT`=false
|
|
|
|
202
|
使用 [U-Boot 引导器](http://git.denx.de/?p=u-boot.git;a=summary) 替代树莓派2/3 默认的第二阶段引导器(bootcode.bin). U-Boot 可以通过网络使用 BOOTP/TFTP 协议引导镜像文件.
|
|
|
|
203
|
|
|
|
|
204
|
##### `UBOOTSRC_DIR`=""
|
|
|
|
205
|
存放已下载 [U-Boot 引导器源文件](http://git.denx.de/?p=u-boot.git;a=summary) 的目录(`u-boot`).
|
|
|
|
206
|
|
|
|
|
207
|
##### `ENABLE_FBTURBO`=false
|
|
|
|
208
|
安装并且允许 [硬件加速的 Xorg 显卡驱动](https://github.com/ssvb/xf86-video-fbturbo) `fbturbo`. 当前仅支持窗口的移动和滚动的硬件加速.
|
|
|
|
209
|
|
|
|
|
210
|
##### `FBTURBOSRC_DIR`=""
|
|
|
|
211
|
设置存放已下载的 [硬件加速的 Xorg 显卡驱动](https://github.com/ssvb/xf86-video-fbturbo) 的目录 (`xf86-video-fbturbo`) , 可以复制到chroot内配置、构建和安装.
|
|
|
|
212
|
|
|
|
|
213
|
##### `ENABLE_IPTABLES`=false
|
|
|
|
214
|
允许 iptables 防火墙. 使用最简单的规则集: 允许所有出站连接;禁止除OpenSSH外的所有入站连接.
|
|
|
|
215
|
|
|
|
|
216
|
##### `ENABLE_USER`=true
|
|
|
|
217
|
创建普通用户, 默认用户名`pi`, 默认密码raspberry. 可以使用 `USER_NAME`=user 更改默认用户名;使用 `USER_PASSWORD`=raspberry 更改默认密码.
|
|
|
|
218
|
|
|
|
|
219
|
##### `USER_NAME`=pi
|
|
|
|
220
|
创建普通用户pi. 如果`ENABLE_USER`=false 此参数被忽略.
|
|
|
|
221
|
|
|
|
|
222
|
##### `ENABLE_ROOT`=false
|
|
|
|
223
|
允许root用户登录, 需要设置 root 用户密码.
|
|
|
|
224
|
|
|
|
|
225
|
##### `ENABLE_HARDNET`=false
|
|
|
|
226
|
允许加固 IPv4/IPv6 协议栈, 防止DoS攻击.
|
|
|
|
227
|
|
|
|
|
228
|
##### `ENABLE_SPLITFS`=false
|
|
|
|
229
|
允许将根分区放在USB驱动器中. 将会生成两个镜像文件, 一个挂载为 `/boot/firmware` , 另一个挂载为 `/`.
|
|
|
|
230
|
|
|
|
|
231
|
##### `CHROOT_SCRIPTS`=""
|
|
|
|
232
|
设置自定义脚本目录的路径, 该目录中的脚本在镜像文件构建完成之前在chroot中运行. 这个目录里的可执行文件按着字典序运行.
|
|
|
|
233
|
|
|
|
|
234
|
##### `ENABLE_INITRAMFS`=false
|
|
|
|
235
|
创建 Linux 启动时加载的 initramfs .如果 `ENABLE_CRYPTFS`=true 那么 `ENABLE_INITRAMFS` 自动设为true . 如果 `BUILD_KERNEL`=false 此参数被忽略.
|
|
|
|
236
|
|
|
|
|
237
|
##### `ENABLE_IFNAMES`=true
|
|
|
|
238
|
允许一致/可预测网络接口命名, 支持 Debian 发行版 `stretch` 或 `buster` .
|
|
|
|
239
|
|
|
|
|
240
|
##### `DISABLE_UNDERVOLT_WARNINGS`=
|
|
|
|
241
|
禁止树莓派2/3 的低电压警告. 设为 `1` 禁止警告. 设为 `2` 额外允许低电压下的turbo增强模式.
|
|
|
|
242
|
|
|
|
|
243
|
---
|
|
|
|
244
|
|
|
|
|
245
|
#### SSH 设置:
|
|
|
|
246
|
##### `SSH_ENABLE_ROOT`=false
|
|
|
|
247
|
允许root通过密码验证方式远程登录系统. 如果没有修改默认密码, 这将是个巨大的安全隐患. `ENABLE_ROOT` 必须设为 `true`.
|
|
|
|
248
|
|
|
|
|
249
|
##### `SSH_DISABLE_PASSWORD_AUTH`=false
|
|
|
|
250
|
禁用SSH的密码验证方式, 只支持SSH (v2)的公钥认证.
|
|
|
|
251
|
|
|
|
|
252
|
##### `SSH_LIMIT_USERS`=false
|
|
|
|
253
|
限制通过SSH远程登录的用户. 只允许由 `USER_NAME`=pi 参数创建的普通用户, 以及当 `SSH_ENABLE_ROOT`=true 时 root 用户远程登录. 如果使用的守护程序是 `dropbear` (通过 `REDUCE_SSHD`=true 设置) 则忽略此参数.
|
|
|
|
254
|
|
|
|
|
255
|
##### `SSH_ROOT_PUB_KEY`=""
|
|
|
|
256
|
从指定文件(可包含多个公钥)添加 SSH (v2) 公钥到 `authorized_keys` 文件, 使得 `root` 用户可以使用SSH (v2)的公钥验证方式远程登录, 不支持SSH (v1). `ENABLE_ROOT` **和** `SSH_ENABLE_ROOT` 必须同时设为 `true`.
|
|
|
|
257
|
|
|
|
|
258
|
##### `SSH_USER_PUB_KEY`=""
|
|
|
|
259
|
从指定文件(可包含多个公钥)添加 SSH (v2) 公钥到 `authorized_keys` 文件, 使得由 `USER_NAME`=pi 参数创建的普通用户可以使用SSH (v2)的公钥验证方式远程登录, 不支持SSH (v1).
|
|
|
|
260
|
|
|
|
|
261
|
---
|
|
|
|
262
|
|
|
|
|
263
|
#### 内核编译:
|
|
|
|
264
|
##### `BUILD_KERNEL`=false
|
|
|
|
265
|
构建安装最新的树莓派 2/3 Linux 内核, 当前只支持默认内核配置. 如果设置为树莓派`3`那么自动设置`BUILD_KERNEL`=true .
|
|
|
|
266
|
|
|
|
|
267
|
##### `CROSS_COMPILE`="arm-linux-gnueabihf-"
|
|
|
|
268
|
设置交叉编译器.
|
|
|
|
269
|
|
|
|
|
270
|
##### `KERNEL_ARCH`="arm"
|
|
|
|
271
|
设置内核架构.
|
|
|
|
272
|
|
|
|
|
273
|
##### `KERNEL_IMAGE`="kernel7.img"
|
|
|
|
274
|
内核镜像名称, 如果没有设置, 编译32位内核默认“kernel7.img” 64位内核默认 "kernel8.img".
|
|
|
|
275
|
|
|
|
|
276
|
##### `KERNEL_BRANCH`=""
|
|
|
|
277
|
GIT里的树莓派内核源代码分支名称, 默认使用当前默认分支.
|
|
|
|
278
|
|
|
|
|
279
|
##### `QEMU_BINARY`="/usr/bin/qemu-arm-static"
|
|
|
|
280
|
设置构建系统中的QEMU程序位置. 如果没有设置, 32位内核默认 “/usr/bin/qemu-arm-static” 64位内核默认 "/usr/bin/qemu-aarch64-static".
|
|
|
|
281
|
|
|
|
|
282
|
##### `KERNEL_DEFCONFIG`="bcm2709_defconfig"
|
|
|
|
283
|
设置编译内核的默认配置. 如果没有设置, 32位内核默认"bcm2709_defconfig" 64位内核默认"bcmrpi3\_defconfig".
|
|
|
|
284
|
|
|
|
|
285
|
##### `KERNEL_REDUCE`=false
|
|
|
|
286
|
缩小内核体积, 移除不想要的设备驱动、网络驱动和文件系统驱动 (实验性质).
|
|
|
|
287
|
|
|
|
|
288
|
##### `KERNEL_THREADS`=1
|
|
|
|
289
|
编译内核时的并发线程数量. 如果使用默认设置, 系统会自动检测CPU的内核数量, 设置线程数量, 加速内核编译.
|
|
|
|
290
|
|
|
|
|
291
|
##### `KERNEL_HEADERS`=true
|
|
|
|
292
|
安装内核相应的头文件.
|
|
|
|
293
|
|
|
|
|
294
|
##### `KERNEL_MENUCONFIG`=false
|
|
|
|
295
|
运行`make menuconfig`使用菜单界面配置内核. 退出配置菜单后脚本继续运行.
|
|
|
|
296
|
|
|
|
|
297
|
##### `KERNEL_REMOVESRC`=true
|
|
|
|
298
|
编译安装完成后, 删掉内核源代码, 产生的镜像不含内核源代码.
|
|
|
|
299
|
|
|
|
|
300
|
##### `KERNELSRC_DIR`=""
|
|
|
|
301
|
已下载好的 [Github上的树莓派官方内核](https://github.com/raspberrypi/linux) 源码所在目录 (`linux`) 的路径, 可以复制到chroot内配置、构建和安装.
|
|
|
|
302
|
|
|
|
|
303
|
##### `KERNELSRC_CLEAN`=false
|
|
|
|
304
|
当`KERNELSRC_DIR`被复制到 chroot 之后开始编译之前(使用 `make mrproper`)清理内核源代码. 如果 `KERNELSRC_DIR` 没有设置或者 `KERNELSRC_PREBUILT`=true时忽略此设置.
|
|
|
|
305
|
|
|
|
|
306
|
##### `KERNELSRC_CONFIG`=true
|
|
|
|
307
|
在编译前使用 `make bcm2709_defconfig` (也可以选择 `make menuconfig`) 配置内核源代码. 如果`KERNELSRC_DIR`指定的源码存放目录不存在,这个参数自动设为 `true`. 如果 `KERNELSRC_PREBUILT`=true 忽略此参数.
|
|
|
|
308
|
|
|
|
|
309
|
##### `KERNELSRC_USRCONFIG`=""
|
|
|
|
310
|
复制自己的配置文件到内核的 `.config`. 如果 `KERNEL_MENUCONFIG`=true 拷贝完成后自动运行 make menuconfig.
|
|
|
|
311
|
|
|
|
|
312
|
##### `KERNELSRC_PREBUILT`=false
|
|
|
|
313
|
如果这个参数设为true 表示内核源代码目录中包含成功交叉编译好的内核. 忽略 `KERNELSRC_CLEAN`, `KERNELSRC_CONFIG`, `KERNELSRC_USRCONFIG` and `KERNEL_MENUCONFIG` 这四个参数,不再执行交叉编译操作.
|
|
|
|
314
|
|
|
|
|
315
|
##### `RPI_FIRMWARE_DIR`=""
|
|
|
|
316
|
指定目录 (`firmware`) 含有已经从 [Github上的树莓派官方固件](https://github.com/raspberrypi/firmware)下载到本地的固件. 默认直接从网上下载最新的固件.
|
|
|
|
317
|
|
|
|
|
318
|
---
|
|
|
|
319
|
|
|
|
|
320
|
#### 缩小体积:
|
|
|
|
321
|
如果 `ENABLE_REDUCE`=false 则忽略下列参数.
|
|
|
|
322
|
|
|
|
|
323
|
##### `REDUCE_APT`=true
|
|
|
|
324
|
配置 APT,压缩仓库文件列表,不缓存下载的包文件.
|
|
|
|
325
|
|
|
|
|
326
|
##### `REDUCE_DOC`=true
|
|
|
|
327
|
移除所有的doc文档文件(harsh). 配置 APT, 将来使用`apt-get`安装deb包时不包括doc文件.
|
|
|
|
328
|
|
|
|
|
329
|
##### `REDUCE_MAN`=true
|
|
|
|
330
|
移除所有的man手册页和info文件 (harsh). 配置 APT, 将来使用`apt-get`安装deb包时不包括man手册页.
|
|
|
|
331
|
|
|
|
|
332
|
##### `REDUCE_VIM`=false
|
|
|
|
333
|
使用vim的小型克隆 `levee` 替代 `vim-tiny`.
|
|
|
|
334
|
|
|
|
|
335
|
##### `REDUCE_BASH`=false
|
|
|
|
336
|
使用 `dash` 代替 `bash` (实验性质).
|
|
|
|
337
|
|
|
|
|
338
|
##### `REDUCE_HWDB`=true
|
|
|
|
339
|
移除与 PCI 相关的 hwdb 文件 (实验性质).
|
|
|
|
340
|
|
|
|
|
341
|
##### `REDUCE_SSHD`=true
|
|
|
|
342
|
使用`dropbear`代替 `openssh-server`.
|
|
|
|
343
|
|
|
|
|
344
|
##### `REDUCE_LOCALE`=true
|
|
|
|
345
|
移除所有的 `locale` 本地化文件.
|
|
|
|
346
|
|
|
|
|
347
|
---
|
|
|
|
348
|
|
|
|
|
349
|
#### 加密根分区:
|
|
|
|
350
|
##### `ENABLE_CRYPTFS`=false
|
|
|
|
351
|
使用dm-crypt进行全盘加密. 创建一个 LUKS 加密根分区 (加密方法 aes-xts-plain64:sha512) 并生成所需要的 initramfs. /boot 目录不会被加密. 当`BUILD_KERNEL`=false时忽略此参数. `ENABLE_CRYPTFS` 这个参数当前是实验性质的. SSH-to-initramfs 当前不支持,正在进行中.
|
|
|
|
352
|
|
|
|
|
353
|
##### `CRYPTFS_PASSWORD`=""
|
|
|
|
354
|
设置根分区的加密密码. 如果 `ENABLE_CRYPTFS`=true,请务必设置此参数.
|
|
|
|
355
|
|
|
|
|
356
|
##### `CRYPTFS_MAPPING`="secure"
|
|
|
|
357
|
设置device-mapper映射名称.
|
|
|
|
358
|
|
|
|
|
359
|
##### `CRYPTFS_CIPHER`="aes-xts-plain64:sha512"
|
|
|
|
360
|
加密算法. 推荐 `aes-xts*`加密法.
|
|
|
|
361
|
|
|
|
|
362
|
##### `CRYPTFS_XTSKEYSIZE`=512
|
|
|
|
363
|
设置密钥长度,8的倍数,以bit为单位.
|
|
|
|
364
|
|
|
|
|
365
|
---
|
|
|
|
366
|
|
|
|
|
367
|
#### Build settings构建设置:
|
|
|
|
368
|
##### `BASEDIR`=$(pwd)/images/${RELEASE}
|
|
|
|
369
|
设置产生镜像的目录.
|
|
|
|
370
|
|
|
|
|
371
|
##### `IMAGE_NAME`=${BASEDIR}/${DATE}-${KERNEL_ARCH}-${KERNEL_BRANCH}-rpi${RPI_MODEL}-${RELEASE}-${RELEASE_ARCH}
|
|
|
|
372
|
设置镜像文件名. 如果`ENABLE_SPLITFS`=false则文件名$IMAGE_NAME.img 如果`ENABLE_SPLITFS`=true则文件名$IMAGE_NAME-frmw.img 和 $IMAGE_NAME-root.img. 如果没有设置 `KERNEL_BRANCH` 则使用 "CURRENT" .
|
|
|
|
373
|
|
|
|
|
374
|
## 理解脚本
|
|
|
|
375
|
制作镜像的每个阶段所实现的功能都由各自的脚本完成, 位于 `bootstrap.d` 目录. 按着字典序执行:
|
|
|
|
376
|
|
|
|
|
377
|
| 脚本 | 说明 |
|
|
|
|
378
|
| --- | --- |
|
|
|
|
379
|
| `10-bootstrap.sh` | 生成基本系统 |
|
|
|
|
380
|
| `11-apt.sh` | 设置 APT 仓库源 |
|
|
|
|
381
|
| `12-locale.sh` | 设置 Locales 和 keyboard |
|
|
|
|
382
|
| `13-kernel.sh` | 编译安装树莓派 2/3 内核 |
|
|
|
|
383
|
| `14-fstab.sh` | 设置 fstab 和 initramfs |
|
|
|
|
384
|
| `15-rpi-config.sh` | 设置 RPi2/3 config and cmdline |
|
|
|
|
385
|
| `20-networking.sh` | 设置网络 |
|
|
|
|
386
|
| `21-firewall.sh` | 设置防火墙 |
|
|
|
|
387
|
| `30-security.sh` | 设置用户以及安全相关 |
|
|
|
|
388
|
| `31-logging.sh` | 设置日志 |
|
|
|
|
389
|
| `32-sshd.sh` | 设置 SSH 和公钥 |
|
|
|
|
390
|
| `41-uboot.sh` | 编译设置 U-Boot |
|
|
|
|
391
|
| `42-fbturbo.sh` | 编译设置 fbturbo Xorg 驱动 |
|
|
|
|
392
|
| `50-firstboot.sh` | 首次启动执行的任务 |
|
|
|
|
393
|
| `99-reduce.sh` | 缩小体积 |
|
|
|
|
394
|
|
|
|
|
395
|
所有需要拷贝到镜像文件的配置文件都位于 `files` 目录. 最好不要手动更改这些配置文件.
|
|
|
|
396
|
|
|
|
|
397
|
| 目录 | 说明 |
|
|
|
|
398
|
| --- | --- |
|
|
|
|
399
|
| `apt` | APT 管理配置文件 |
|
|
|
|
400
|
| `boot` | 引导文件 树莓派2/3配置文件 |
|
|
|
|
401
|
| `dpkg` | 包管理配置文件 |
|
|
|
|
402
|
| `etc` | 配置文件以及 rc 启动脚本 |
|
|
|
|
403
|
| `firstboot` | 首次引导执行的脚本 |
|
|
|
|
404
|
| `initramfs` | Initramfs 脚本 |
|
|
|
|
405
|
| `iptables` | 防火墙配置文件 |
|
|
|
|
406
|
| `locales` | Locales 配置 |
|
|
|
|
407
|
| `modules` | 内核模块配置 |
|
|
|
|
408
|
| `mount` | Fstab 配置 |
|
|
|
|
409
|
| `network` | 网络配置文件 |
|
|
|
|
410
|
| `sysctl.d` | 交换文件以及IP协议加固配置文件 |
|
|
|
|
411
|
| `xorg` | fbturbo Xorg 驱动配置 |
|
|
|
|
412
|
|
|
|
|
413
|
## 自定义包和脚本
|
|
|
|
414
|
`packages` 目录里放置自定义deb包, 比如系统仓库里没有的软件.在安装完系统仓库中的包之后安装. 自定义包所依赖的deb包会自动从系统仓库下载. 不要把自定义包添加到 `APT_INCLUDES` 参数中.
|
|
|
|
415
|
`custom.d` 目录中的脚本会在其它安装都完成后, 创建镜像文件之前执行.
|
|
|
|
416
|
|
|
|
|
417
|
## 记录镜像产生过程的信息
|
|
|
|
418
|
所有镜像产生过程的信息、`rpi23-gen-image.sh` 脚本执行的命令都可以通过shell的 `script` 命令保存到日志文件中:
|
|
|
|
419
|
|
|
|
|
420
|
```shell
|
|
|
|
421
|
script -c 'APT_SERVER=ftp.de.debian.org ./rpi23-gen-image.sh' ./build.log
|
|
|
|
422
|
```
|
|
|
|
423
|
|
|
|
|
424
|
## 烧录镜像文件
|
|
|
|
425
|
`rpi23-gen-image.sh` 所生成的镜像文件需要使用 `bmaptool` 或 `dd` 烧录到 microSD 卡. `bmaptool` 速度快比 `dd` 聪明.
|
|
|
|
426
|
|
|
|
|
427
|
##### 烧录示例:
|
|
|
|
428
|
```shell
|
|
|
|
429
|
bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie.img /dev/mmcblk0
|
|
|
|
430
|
dd bs=4M if=./images/jessie/2017-01-23-rpi3-jessie.img of=/dev/mmcblk0
|
|
|
|
431
|
```
|
|
|
|
432
|
如果设置过 `ENABLE_SPLITFS`, 烧录 `-frmw` 文件到 microSD 卡, 烧录 `-root` 文件到 USB 驱动器:
|
|
|
|
433
|
```shell
|
|
|
|
434
|
bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie-frmw.img /dev/mmcblk0
|
|
|
|
435
|
bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie-root.img /dev/sdc
|
|
|
|
436
|
```
|
|
|
|
437
|
## 每周镜像
|
|
|
|
438
|
这些镜像由JRWR'S I/O PORT提供, 每周日午夜UTC 0点编译!
|
|
|
|
439
|
* [Debian Stretch Raspberry Pi2/3 周构建镜像](https://jrwr.io/doku.php?id=projects:debianpi)
|
|
|
|
440
|
|
|
|
|
441
|
## External links and references外部链接, 各种资源
|
|
|
|
442
|
* [Debian 全世界镜像列表](https://www.debian.org/mirror/list)
|
|
|
|
443
|
* [Debian 树莓派 2 Wiki](https://wiki.debian.org/RaspberryPi2)
|
|
|
|
444
|
* [Debian 交叉工具链 Wiki](https://wiki.debian.org/CrossToolchains)
|
|
|
|
445
|
* [Github上的树莓派官方固件](https://github.com/raspberrypi/firmware)
|
|
|
|
446
|
* [Github上的树莓派官方内核](https://github.com/raspberrypi/linux)
|
|
|
|
447
|
* [U-BOOT git 仓库](http://git.denx.de/?p=u-boot.git;a=summary)
|
|
|
|
448
|
* [Xorg DDX fbturbo驱动](https://github.com/ssvb/xf86-video-fbturbo)
|
|
|
|
449
|
* [树莓派3无线接口固件](https://github.com/RPi-Distro/firmware-nonfree/tree/master/brcm80211/brcm)
|
|
|
|
450
|
* [Collabora 树莓派2预编译内核](https://repositories.collabora.co.uk/debian/)
|
