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