├── .nojekyll
├── LICENSE
├── README.md
├── index.html
└── others
    ├── ask-a-question.md
    └── friendlywrt.md


/.nojekyll:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/nicholas-opensource/R2S-Wiki/9184c1b5008cab91053efbd0299c4929e7ed3848/.nojekyll


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                                  Apache License
  2 |                            Version 2.0, January 2004
  3 |                         http://www.apache.org/licenses/
  4 | 
  5 |    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
  6 | 
  7 |    1. Definitions.
  8 | 
  9 |       "License" shall mean the terms and conditions for use, reproduction,
 10 |       and distribution as defined by Sections 1 through 9 of this document.
 11 | 
 12 |       "Licensor" shall mean the copyright owner or entity authorized by
 13 |       the copyright owner that is granting the License.
 14 | 
 15 |       "Legal Entity" shall mean the union of the acting entity and all
 16 |       other entities that control, are controlled by, or are under common
 17 |       control with that entity. For the purposes of this definition,
 18 |       "control" means (i) the power, direct or indirect, to cause the
 19 |       direction or management of such entity, whether by contract or
 20 |       otherwise, or (ii) ownership of fifty percent (50%) or more of the
 21 |       outstanding shares, or (iii) beneficial ownership of such entity.
 22 | 
 23 |       "You" (or "Your") shall mean an individual or Legal Entity
 24 |       exercising permissions granted by this License.
 25 | 
 26 |       "Source" form shall mean the preferred form for making modifications,
 27 |       including but not limited to software source code, documentation
 28 |       source, and configuration files.
 29 | 
 30 |       "Object" form shall mean any form resulting from mechanical
 31 |       transformation or translation of a Source form, including but
 32 |       not limited to compiled object code, generated documentation,
 33 |       and conversions to other media types.
 34 | 
 35 |       "Work" shall mean the work of authorship, whether in Source or
 36 |       Object form, made available under the License, as indicated by a
 37 |       copyright notice that is included in or attached to the work
 38 |       (an example is provided in the Appendix below).
 39 | 
 40 |       "Derivative Works" shall mean any work, whether in Source or Object
 41 |       form, that is based on (or derived from) the Work and for which the
 42 |       editorial revisions, annotations, elaborations, or other modifications
 43 |       represent, as a whole, an original work of authorship. For the purposes
 44 |       of this License, Derivative Works shall not include works that remain
 45 |       separable from, or merely link (or bind by name) to the interfaces of,
 46 |       the Work and Derivative Works thereof.
 47 | 
 48 |       "Contribution" shall mean any work of authorship, including
 49 |       the original version of the Work and any modifications or additions
 50 |       to that Work or Derivative Works thereof, that is intentionally
 51 |       submitted to Licensor for inclusion in the Work by the copyright owner
 52 |       or by an individual or Legal Entity authorized to submit on behalf of
 53 |       the copyright owner. For the purposes of this definition, "submitted"
 54 |       means any form of electronic, verbal, or written communication sent
 55 |       to the Licensor or its representatives, including but not limited to
 56 |       communication on electronic mailing lists, source code control systems,
 57 |       and issue tracking systems that are managed by, or on behalf of, the
 58 |       Licensor for the purpose of discussing and improving the Work, but
 59 |       excluding communication that is conspicuously marked or otherwise
 60 |       designated in writing by the copyright owner as "Not a Contribution."
 61 | 
 62 |       "Contributor" shall mean Licensor and any individual or Legal Entity
 63 |       on behalf of whom a Contribution has been received by Licensor and
 64 |       subsequently incorporated within the Work.
 65 | 
 66 |    2. Grant of Copyright License. Subject to the terms and conditions of
 67 |       this License, each Contributor hereby grants to You a perpetual,
 68 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 69 |       copyright license to reproduce, prepare Derivative Works of,
 70 |       publicly display, publicly perform, sublicense, and distribute the
 71 |       Work and such Derivative Works in Source or Object form.
 72 | 
 73 |    3. Grant of Patent License. Subject to the terms and conditions of
 74 |       this License, each Contributor hereby grants to You a perpetual,
 75 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 76 |       (except as stated in this section) patent license to make, have made,
 77 |       use, offer to sell, sell, import, and otherwise transfer the Work,
 78 |       where such license applies only to those patent claims licensable
 79 |       by such Contributor that are necessarily infringed by their
 80 |       Contribution(s) alone or by combination of their Contribution(s)
 81 |       with the Work to which such Contribution(s) was submitted. If You
 82 |       institute patent litigation against any entity (including a
 83 |       cross-claim or counterclaim in a lawsuit) alleging that the Work
 84 |       or a Contribution incorporated within the Work constitutes direct
 85 |       or contributory patent infringement, then any patent licenses
 86 |       granted to You under this License for that Work shall terminate
 87 |       as of the date such litigation is filed.
 88 | 
 89 |    4. Redistribution. You may reproduce and distribute copies of the
 90 |       Work or Derivative Works thereof in any medium, with or without
 91 |       modifications, and in Source or Object form, provided that You
 92 |       meet the following conditions:
 93 | 
 94 |       (a) You must give any other recipients of the Work or
 95 |           Derivative Works a copy of this License; and
 96 | 
 97 |       (b) You must cause any modified files to carry prominent notices
 98 |           stating that You changed the files; and
 99 | 
100 |       (c) You must retain, in the Source form of any Derivative Works
101 |           that You distribute, all copyright, patent, trademark, and
102 |           attribution notices from the Source form of the Work,
103 |           excluding those notices that do not pertain to any part of
104 |           the Derivative Works; and
105 | 
106 |       (d) If the Work includes a "NOTICE" text file as part of its
107 |           distribution, then any Derivative Works that You distribute must
108 |           include a readable copy of the attribution notices contained
109 |           within such NOTICE file, excluding those notices that do not
110 |           pertain to any part of the Derivative Works, in at least one
111 |           of the following places: within a NOTICE text file distributed
112 |           as part of the Derivative Works; within the Source form or
113 |           documentation, if provided along with the Derivative Works; or,
114 |           within a display generated by the Derivative Works, if and
115 |           wherever such third-party notices normally appear. The contents
116 |           of the NOTICE file are for informational purposes only and
117 |           do not modify the License. You may add Your own attribution
118 |           notices within Derivative Works that You distribute, alongside
119 |           or as an addendum to the NOTICE text from the Work, provided
120 |           that such additional attribution notices cannot be construed
121 |           as modifying the License.
122 | 
123 |       You may add Your own copyright statement to Your modifications and
124 |       may provide additional or different license terms and conditions
125 |       for use, reproduction, or distribution of Your modifications, or
126 |       for any such Derivative Works as a whole, provided Your use,
127 |       reproduction, and distribution of the Work otherwise complies with
128 |       the conditions stated in this License.
129 | 
130 |    5. Submission of Contributions. Unless You explicitly state otherwise,
131 |       any Contribution intentionally submitted for inclusion in the Work
132 |       by You to the Licensor shall be under the terms and conditions of
133 |       this License, without any additional terms or conditions.
134 |       Notwithstanding the above, nothing herein shall supersede or modify
135 |       the terms of any separate license agreement you may have executed
136 |       with Licensor regarding such Contributions.
137 | 
138 |    6. Trademarks. This License does not grant permission to use the trade
139 |       names, trademarks, service marks, or product names of the Licensor,
140 |       except as required for reasonable and customary use in describing the
141 |       origin of the Work and reproducing the content of the NOTICE file.
142 | 
143 |    7. Disclaimer of Warranty. Unless required by applicable law or
144 |       agreed to in writing, Licensor provides the Work (and each
145 |       Contributor provides its Contributions) on an "AS IS" BASIS,
146 |       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 |       implied, including, without limitation, any warranties or conditions
148 |       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 |       PARTICULAR PURPOSE. You are solely responsible for determining the
150 |       appropriateness of using or redistributing the Work and assume any
151 |       risks associated with Your exercise of permissions under this License.
152 | 
153 |    8. Limitation of Liability. In no event and under no legal theory,
154 |       whether in tort (including negligence), contract, or otherwise,
155 |       unless required by applicable law (such as deliberate and grossly
156 |       negligent acts) or agreed to in writing, shall any Contributor be
157 |       liable to You for damages, including any direct, indirect, special,
158 |       incidental, or consequential damages of any character arising as a
159 |       result of this License or out of the use or inability to use the
160 |       Work (including but not limited to damages for loss of goodwill,
161 |       work stoppage, computer failure or malfunction, or any and all
162 |       other commercial damages or losses), even if such Contributor
163 |       has been advised of the possibility of such damages.
164 | 
165 |    9. Accepting Warranty or Additional Liability. While redistributing
166 |       the Work or Derivative Works thereof, You may choose to offer,
167 |       and charge a fee for, acceptance of support, warranty, indemnity,
168 |       or other liability obligations and/or rights consistent with this
169 |       License. However, in accepting such obligations, You may act only
170 |       on Your own behalf and on Your sole responsibility, not on behalf
171 |       of any other Contributor, and only if You agree to indemnify,
172 |       defend, and hold each Contributor harmless for any liability
173 |       incurred by, or claims asserted against, such Contributor by reason
174 |       of your accepting any such warranty or additional liability.
175 | 
176 |    END OF TERMS AND CONDITIONS
177 | 
178 |    APPENDIX: How to apply the Apache License to your work.
179 | 
180 |       To apply the Apache License to your work, attach the following
181 |       boilerplate notice, with the fields enclosed by brackets "[]"
182 |       replaced with your own identifying information. (Don't include
183 |       the brackets!)  The text should be enclosed in the appropriate
184 |       comment syntax for the file format. We also recommend that a
185 |       file or class name and description of purpose be included on the
186 |       same "printed page" as the copyright notice for easier
187 |       identification within third-party archives.
188 | 
189 |    Copyright [yyyy] [name of copyright owner]
190 | 
191 |    Licensed under the Apache License, Version 2.0 (the "License");
192 |    you may not use this file except in compliance with the License.
193 |    You may obtain a copy of the License at
194 | 
195 |        http://www.apache.org/licenses/LICENSE-2.0
196 | 
197 |    Unless required by applicable law or agreed to in writing, software
198 |    distributed under the License is distributed on an "AS IS" BASIS,
199 |    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 |    See the License for the specific language governing permissions and
201 |    limitations under the License.
202 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | ## NanoPi-R2S 操作手册
  2 | 
  3 |   欢迎查看 NanoPi-R2S 操作手册。本页旨在为 [NanoPi R2S/R4S Club](https://is.gd/nanopi_r4s) ，收集与解答 NanoPi-R2S 相关问题。  
  4 |   如有更好的意见与建议，随时欢迎 PR。  
  5 |   或者群内相关发言时直接 @NickBotNLP  
  6 |   *原 NanoPi R2S Club 用户已基本转移到 [NanoPi R4S Club](https://is.gd/nanopi_r4s) ，欢迎前来讨论任何 OpenWrt 相关问题。*  
  7 |   **盗我一字，男盗女娼。**
  8 | 
  9 | ### 1、R2S 基本介绍
 10 | 
 11 |   [NanoPi R2S](https://wiki.friendlyarm.com/wiki/index.php/NanoPi_R2S/zh) 是友善电子团队最新推出的一款实现满速率双千兆的、完全开源的 IoT 应用神器。  
 12 | 
 13 |   NanoPi R2S 使用 RK3328 Soc，有两个千兆网络，1G DDR4 内存，支持 Docker CE，完全开源，用于企业物联网二次开发，个人定制 NAS，家庭物联网网关等。  
 14 | 
 15 | #### 1.1 开发板参数介绍
 16 | 
 17 | <details>
 18 |   <summary>点击展开查看详细内容</summary>
 19 |   <pre>
 20 |   > Soc： Rockchip RK3328, Quad-core Cortex-A53  
 21 |   > 内存： DDR4, 1 GB  
 22 |   > 网口：  
 23 |     RTL8211E（10 / 100 / 1000 Mbps 以太网口 x 1）  
 24 |     RTL8153B（USB 3.0 转 10 / 100 / 1000 Mbps 以太网口 x 1）  
 25 |   > USB 接口：USB 2.0 Type-A x1  
 26 |   > TF 卡槽 x 1  
 27 |   > MicroUSB：供电和 Slave 功能  
 28 |   > Debug Serial Port：3.3V TTL 电平，3 Pin 2.54 mm 间距排针  
 29 |   > LED 灯：LED x 3  
 30 |   > 按键：Reset 按键 x 1（可用户自定义功能）  
 31 |   > 开发板尺寸：55.6 x 52 mm  
 32 |   > 供电：直流 5V / 2A  
 33 |   > 使用温度：0℃ 到 80℃  
 34 |   </pre>
 35 | </details>
 36 | 
 37 | ---
 38 | 
 39 | #### 1.2 灯光按键介绍
 40 | 
 41 | * 灯光前面板由 WAN LAN 绿色指示灯 和 SYS 红色指示灯 组成，WAN LAN 指示灯在部分固件下不能亮起，SYS 指示灯在开机状态时，是红色双闪状态。  
 42 | 
 43 | * 如果遇到红灯常亮等特殊状态，则说明系统未启动，或者 TF卡 不兼容等状态。插入网线连接其他设备后，网口高低电平灯闪烁，则说明链路状态正常。  
 44 | 
 45 | * 若开机后网口灯不正常，或者熄灭，则说明系统未启动或遇到错误。    
 46 | 
 47 | * 类原生固件灯光说明：  
 48 |     
 49 |   > 2020 年 7 月 17 日后，SYS 灯引导时闪烁，启动后常亮和 LAN 口网口灯不亮是正常现象。  
 50 |   > 2020 年 7 月 22 日后，加入新 Patch 解决 LAN 口网口灯不亮的问题。电平灯和 WAN 相反（接入后黄灯常亮，传输数据时绿灯闪烁）。  
 51 |   > 2020 年 7 月 28 日后，官方正式编写代码支持 LAN 口电平灯显示，状态和 WAN 相同（接入后绿灯常亮，传输数据时黄灯闪烁）。  
 52 |   > 至此，一切灯光正常。   
 53 | 
 54 | ---
 55 | 
 56 | ### 2、R2S 所需配件
 57 | 
 58 | #### 2.1 电源线和电源的选择
 59 | 
 60 |   R2S 推荐使用 5V / 2A 的 USB 电源，stress 烤机下满载电流 0.8A。  
 61 | 
 62 |   建议使用质量可靠的 USB 线缆 USB-A 或 USB-C 至 MicroUSB。  
 63 | 
 64 |   *<注意请慎用 QC 类的充电头供电，以免电压识别有误供电电压过高损坏设备>*  
 65 | 
 66 | ---
 67 | 
 68 | #### 2.2 TF 储存卡的选择及相关问题
 69 | 
 70 |   NanoPi R2S 没有内置储存器，使用外置插入式 TF 卡。TF 卡的兼容性和稳定性决定着固件刷写的成功与否，以及后续使用更新固件的稳定性。  
 71 | 
 72 | ##### 2.2.1 TF 卡推荐
 73 | 
 74 | * 本群推荐使用 “朗科与京东联名的 Class10 / SDHC / A1 的 TF 卡”  
 75 | 
 76 |   *<主要是便宜、能用、且拥有京东提供后续保修及换新服务（ 仅 Plus 会员 ）>*  
 77 | 
 78 | * 某宝等渠道的 “SanDisk Industrial 闪迪工业卡” 。从网友的反馈来看属 MLC 类型 TF 卡，且没 TLC 的擦写缺陷，适合频繁刷机。相比 TLC 拥有更长使用寿命，以及高至 85 度的工作温度。但渠道来源存在风险，请自行判断。  
 79 | 
 80 | * 另外可选用 TF 转 eMMC 的特殊 TF 卡，使用上稳定性最佳，但会破坏整体外观（极客选择，并不推荐)。  
 81 | 
 82 | ##### 2.2.2 TF 卡刷写固件
 83 | 
 84 | * 写卡软件：  
 85 | 
 86 |   > Windows 下建议使用 [win32diskimager](https://win32diskimager.download) 和 [rufus](https://rufus.ie)。  
 87 |   >
 88 |   > macOS 建议使用 [balenaEtcher](https://www.balena.io/etcher/)（macOS 和 Linux 也可直接在命令行下用 dd 写入）  
 89 | 
 90 | * 普通市售 TLC 类型的 TF 卡，由于可能存在"擦除缺陷"，建议在刷写固件前，尽量做覆盖填充，可选择完全格式化或进行快速格式化后填入一些大文件。  
 91 | 
 92 | * 如选用 SquashFS 格式固件，建议刷写成功后 SSH 登入运行命令 `firstboot -y && reboot now` 完全清理。  
 93 | 
 94 | * 覆盖写入可被写入精心设计的 2GB 空文件所代替，节约大量时间。无残留，获得更好体验。  
 95 | 
 96 |   > 下载地址： [Restore-SD-Card-2G.zip](https://openwrt.cc/restore/Restore-SD-Card-2G.zip) （ 文件大小仅为约 1.7 MiB 左右 ）  
 97 |   >
 98 |   > 使用方法：先使用写卡软件写入 Restore-SD-Card-2G.zip ，拔出读卡器并重新插入，再写入真正的软件包即可。  
 99 |   >
100 |   > 感谢群友 SuLingGG 的辛苦付出。  
101 | 
102 | ##### 2.2.3 TF 卡的其他常见问题
103 | 
104 | * Q: 为什么启动不了系统？  
105 |   A: 首先根据上文确定是不是设置错误。比如 LAN WAN 互换，比如未自动获取 IP 地址。建议根据 2.2.2 的教程重新刷写TF卡。  
106 |     *<另外部分 TF 卡不兼容 R2S，常见能使用兼容 ext4 格式固件而不能使用 SquashFS 格式固件启动>*  
107 | 
108 | * Q: 为什么 TF 卡读取不了/卡容量减少/刷卡掉速？  
109 |   A: 建议使用专业软件删除分区，重新格式化 TF 卡。或更换读卡器。出现严重问题联系销售商换新。  
110 | 
111 | * Q: 刷了 SquashFS 的系统为什么原来的配置还在？  
112 |   A: 因为 TLC 类型 TF 卡的特性，SquashFS 格式的系统存在的 Upper Layer 可能没有被擦除。特别是同系列的固件 RootFS 大小相同时会出现此类状况。[详情链接](https://openwrt.org/docs/guide-user/troubleshooting/failsafe_and_factory_reset)  
113 | 
114 |   解决方案：使用 SSH 等工具进 入R2S 输入：  
115 |   ```shell  
116 |   jffs2reset -y && reboot now
117 |   ```
118 | * Q: 为什么重启后配置丢失？  
119 |   A: 如果您使用的是 SquashFS 文件系统的固件，请再刷机后参照上一条执行清理 Upper Layer 或者 重新挂载 Overlay 分区。如果您使用的是 Ext4 文件系统的固件，请确定 TF 卡是可写入的状态，确定写入的文件及更改已切实写入TF卡，而不是存在于运行 RAM 中。如果遇到连续出现问题或者卡写保护等情况，建议更换 TF 卡，具体请参照 2.2.1 条目。  
120 | 
121 |   **其他问题请先学会善用 [搜索引擎](https://www.google.com)，尝试自行解决，对于无法自行解决的问题欢迎阅读 [提问的艺术](https://github.com/betaseeker/How-To-Ask-Questions) 后在 Telegram 群 [NanoPi R4S Club](https://is.gd/nanopi_r4s) 中提出、讨论。**  
122 | 
123 | ---
124 | 
125 | #### 2.3 散热选择
126 | 
127 | * RK3328 是 4 核 A53，在日常使用中，发热量偏大。需要散热来保证不会达到温度墙而掉频。RK3328 的温度墙是 85℃。  
128 | * 本节主要介绍由 R2S 群组发起打造的被动散热铝合金外壳，以及友善厂家前后推出的外壳及其它散热措施。  
129 | 
130 | ##### 2.3.1 铝合金外壳  
131 | 
132 |   所有铝合金外壳皆出自 Telegram 群 NanoPi R2S Club 。感谢群友们为 NanoPi R2S 所做的贡献。  
133 |   友善厂家现推出外壳发售，神似 R2S Club 群组的第一代外壳。  
134 |   
135 |   __来自 Telegram 群 NanoPi R2S Club 的众筹定制外壳已经全部售罄，感谢大家半年多的努力。经历了三代半的变化，外壳变成现在成熟的样子，每一代的进步都离不开大家的帮助，非常非常感谢为此努力的所有人。__
136 | 
137 | ###### 2.3.1.1 铝合金外壳区别  
138 | 
139 |   外壳目前分为一代外壳，二代外壳，二代半外壳和三代外壳。  
140 | 
141 |   > 一代外壳：为铝合金构造，外表做氧化发黑处理，黑色高级纹理搭配顶部散热鳍片。TF 卡 和 USB 做开孔处理，其中限量版首批 300 件有特殊 Logo。  
142 | 
143 |   > 二代外壳：为铝合金构造，外表做磨砂氧化处理，保持铝合金原色，去掉顶部鳍片和 TF 卡槽，整体更协调，颜值在线。  
144 | 
145 |   > 二代半外壳：为铝合金构造，外表做磨砂氧化处理，保持铝合金原色，相比于二代加入重新设计开孔 TF 卡槽，插卡取卡更便捷。  
146 | 
147 |   > 三代外壳：在二代半外壳的基础上，加入 0.91 英寸 OLED 屏幕（详见 2.5 条目），简单安装方法，信息获取更高效。  
148 | 
149 |   > 友善厂家外壳：类似于一代外壳，用料变薄，优化 TF 卡口 和 外形设计，外观精致。但 Soc 铝柱变短，靠硅脂垫连接 Soc，背后无压片。硅脂垫导热性能略微欠佳，极客用户可根据需求选购 15 x 15 x 0.3 毫米的铜片，两边涂抹上硅脂，来替代硅脂垫获得更佳的散热效果。  
150 | 
151 | ###### 2.3.1.2 安装方法  
152 | 
153 |   暂略。正确安装才能保证良好散热效果，安装正确的铝合金外壳绝对能应付包括不透风弱电箱等非极端环境下正常使用。如有安装困难或温度过高，不明安装方法可加入 Telegram 群 [NanoPi R4S Club](https://is.gd/nanopi_r4s)  
154 | 
155 | ###### 2.3.1.3 半导体和风扇  
156 | 
157 |   半导体制冷片采用珀耳帖效应，安装在铝壳上可显著降低 Soc 温度。  
158 |   注意做好热面散热和温控，否则会损坏制冷片和凝水导致 R2S 主板进液。  
159 |   外壳外加装风扇会进一步降低 Soc 的温度。  
160 |   交流讨论可加入 Telegram 群 [NanoPi R4S Club](https://is.gd/nanopi_r4s)  
161 | 
162 | ###### 2.3.1.4 常见问题  
163 | 
164 | * Q: 铝合金外壳能降低到多少度？  
165 |     A: 这个要根据室温和空气流通速度来决定。铝合金外壳的最主要目的是满负载情况下能不碰温度墙，稳定 1608 MHz 的 Soc 主频不掉频，全力输出。以以往的经验来说，待机状态下 Soc 温度是室温 +20℃ 以内，弱电箱内 +25℃ 以内。如果温度过高应检查安装问题特别是散热柱与 CPU 是否紧密接触，应使用散热硅脂等确保有良好接触面导热。  
166 | 
167 | * Q: 绝缘胶带需要贴吗？  
168 |     A: 可贴可不贴。 尽量注意做好绝缘保护，否则会因短路引起关机保护。  
169 | 
170 | * Q: 硅脂溢出到主板上怎么办？  
171 |     A: 大部分硅脂不导电，没影响。  
172 | 
173 | * Q: 板子安装不进去怎么办？  
174 |     A: R2S的主板制造过程是从整块大主板上裁切，会有一定的公差。用指甲刀锉一下边缘毛边。  
175 | 
176 | * Q: 硅脂垫是干什么的？可以不用吗？  
177 |     A: 硅脂垫是贴主板后侧到铝壳底盖的，主要充当散热器弹簧的用途，给 Soc 和铝柱一个额外的压力，帮助更好散热。  
178 | 
179 | * Q: 群内外壳和友善外壳有什么区别？  
180 |     A: 群内外壳已经众筹到最后一批，卖一个少一个，即将售罄绝版。拥有 OLED 的非凡乐趣和更佳的散热能力。友善外壳靠硅脂垫连接，散热会差一些，但是正常使用和非长时间暴力烤鸡不会碰触温度墙，可正常使用。  
181 | 
182 |   **其他问题请先学会善用 [搜索引擎](https://www.google.com)，尝试自行解决，对于无法自行解决的问题欢迎阅读 [提问的艺术](https://github.com/betaseeker/How-To-Ask-Questions) 后在 Telegram 群 [NanoPi R4S Club](https://is.gd/nanopi_r4s) 中提出、讨论。**  
183 | 
184 | ##### 2.3.2 风扇外壳
185 | 
186 |   无论是网售亚克力定制的外壳还是原装风扇散热片（裸奔情况下）或其它自制的主动风扇散热方案，都可以显著降低待机温度，满足日常使用。但在极端满载情况下，还是会撞温度墙。如有极端需求还需暴力改造。 主动散热风扇也是故障点，注意维护使用。
187 | 
188 | ##### 2.3.3 其他被动散热
189 | 
190 |   无论是原装散热片还是加装其他散热片，只要满足不装外壳，存放于空气强流通处，都能显著降低待机温度。  
191 | 
192 | ---
193 | 
194 | #### 2.4 USB 网卡
195 | 
196 |   大多数无线网卡的驱动支持和使用体验都不好，暂无任何值得推荐使用的型号。  
197 |  
198 |   如果您非要使用 USB 无线网卡作为 AP 来使用，推荐选用 Netgear A6210 和 ASUS AC55 ，或选用更廉价的 811AC 网卡，固件请选择 ImortalWrt （详见 4.2 条目）。    
199 | 
200 |   OpenWrt 支持 USB 的 4G 上网卡，具体请参考有编译支持的固件说明（目前主要支持 Hilink 模式）。  
201 | 
202 | ---
203 | 
204 | #### 2.5 OLED 屏幕
205 | 
206 |   目前 OLED 屏幕分为 “0.96 寸狼牙山五壮士版”，和 “三代铝壳自带 0.91 寸屏幕”。  
207 | 
208 |   “ 0.91 寸屏幕 ” 可使用 NateLol 大佬的 [luci-app-oled](https://github.com/NateLol/luci-app-oled) 来选择显示内容（部分固件编译内置）。  
209 | 
210 | ---
211 | 
212 | #### 2.6 其他外设
213 | 
214 |   狼牙山五壮士等特殊外设。  
215 | 
216 | ---
217 | 
218 | ### 3、R2S 主要功能  
219 | 
220 | #### 3.1 路由器
221 | 
222 |   超小体积的双千兆网口的 ARM 四核 A53 开发板，非常适合做软路由器。  
223 | 
224 | ##### 3.1.1 主路由  
225 | 
226 |   双网口分别用于LAN、WAN，结构简单，推荐大多数场合使用。R2S Club 群组测试双网口 NAT 转发性能 940 Mbps，已跑满千兆网口。 
227 | 
228 | ##### 3.1.2 单臂路由  
229 | 
230 |   单网口接 VLAN 交换机，使用 VLAN 区分 LAN、WAN，单线复用。参考 IEEE 802.1q 协议等资料。 （简单 PPPoE-WAN 也可不用 VLAN 隔离，单网口既做 LAN 又兼承载 PPPoE） 
231 | 
232 | ##### 3.1.3 “旁路由”  
233 | 
234 |   极不推荐。  
235 | 
236 | ---
237 | 
238 | #### 3.2 Linux 服务器和 Docker 容器
239 | 
240 |   支持 Armbian 稳定版 和 Ubuntu 等版本，绝大多数系统下支持 Docker，如 Armbian 的 Docker OpenWrt，OpenWrt 下 Docker Awtrix 等等操作。  
241 |   详见 4.3 和 4.4 条目。  
242 | 
243 | ---
244 | 
245 | #### 3.3 电视盒子
246 | 
247 |   *<尚未开发>*  
248 | 
249 | ---
250 | 
251 | #### 3.4 暖手宝
252 | 
253 |   *<皮一下很开心。————Nick Bot>*  
254 | 
255 | ---
256 | 
257 | ### 4、R2S 主要固件介绍
258 | 
259 | #### 4.1 原生 OpenWrt 固件
260 | 
261 | ##### 4.1.1 OpenWrt 官方主线支持 R2S
262 | 
263 | * 2020 年 7 月 28 日，OpenWrt 官方主线加入了对 NanoPi R2S 的正式支持，使用 Longterm Kernel 5.4 内核。感谢为此付出努力的一众网友，感谢 [OpenWrt](https://openwrt.org/) 官方、[Project OpenWrt（现 Immortalwrt ）](https://github.com/immortalwrt) 项目组 和 [Quintus Chu](https://t.me/quintuschu) 大佬，感谢世界各地为开源社区努力贡献的朋友们。  
264 | 
265 |   源码地址：[openwrt/openwrt](https://github.com/openwrt/openwrt)  
266 | 
267 | ##### 4.1.2 R2S Club 群友基于原生 OpenWrt 源码提供的预编译固件
268 | 
269 |   源于开源社区的努力，使用 OpenWrt 官方源码，各路大佬按自身所需定制编译。 __有特殊需求者请自行编译，不提供任何免费技术支持__ ，现成固件请自行甄选使用。OpenWrt 固件分为 EXT4 格式版本及 SquashFS 格式版本，若使用 TLC 类型 TF 卡写入 SquashFS 格式的固件启动失败，才建议换用 EXT4 格式固件。SquashFS 格式固件可在误配置等情况下使用恢复固件初始设置重置系统（使用 LuCI 管理页面相关菜单或使用 `firstboot` 等命令），EXT4 格式则不具备此功能。下列基于原生 OpenWrt 源码编译固件均提供 SquashFS 格式，部分提供 EXT4 格式。  
270 | 
271 |   __固件介绍详见各固件仓库主页的 README 和 Releases。__ 部分超频固件保持 1.45V 电压超频至 1608 MHz，发热不变，更高性能。部分固件自带 Soc 调频，不懂不要动。电压表 1 GHz 下都相同，不建议频率低于 800 MHz，一切问题后果自负。若出现反复重启不能稳定，说明 Soc 体质偏差，建议放弃超频。下载纯原生 OpenWrt/OpenWrt 的固件会导致 DDR4 内存运行在 333MHz 的频率上，内存读写性能变为正常的 1/3 ，下列的固件都修复了此问题。  
272 | 
273 |   设置错误或误操作后，SquashFS 可执行重置，部分固件带了 `fuck` 组件清除残留设置，使用更佳。强烈建议在刷写 SquashFS 固件后执行 `fuck` 或者 `firstboot -y && reboot now` ，使用备份和升级保留备份前请务必确保清楚了解所做的操作。  
274 | 
275 | * QiuSimons（404 大佬）  
276 |   地址：[QiuSimons/YAOF](https://github.com/qiusimons/YAOF)  
277 | 
278 | * Nick Bot  
279 |   地址：[nicholas-opensource/OpenWrt-Autobuild](https://github.com/nicholas-opensource/OpenWrt-Autobuild)  
280 | 
281 | * 墨子冥  
282 |   地址：[msylgj/R2S-R4S-OpenWrt](https://github.com/msylgj/R2S-R4S-OpenWrt)  
283 | 
284 | * RikudouPatrickstar（派大星大佬）  
285 |   地址：[RikudouPatrickstar/R2S-OpenWrt](https://github.com/RikudouPatrickstar/R2S-OpenWrt)  
286 | 
287 |   **欢迎补充，欢迎您为开源社区作出贡献。如果您在 Telegram [NanoPi R4S Club](https://is.gd/nanopi_r4s) 群内询问哪个固件最好用/最稳定等愚蠢问题，您将被移出群聊，因为您没有阅读 Wiki，以及您并没有看到这行文字。**  
288 |   
289 | ##### 4.1.3 基于 Jayanta525 源码的类原生固件（已弃用）
290 | 
291 |   使用 [Jayanta525/openwrt-nanopi-r2s](https://github.com/jayanta525/openwrt-nanopi-r2s) 的源码，是原生支持前的重要阶段。但是有未改好 IRQ 等等问题，使用舒适度和性能完整度较落后于 OpenWrt 官方以及群友发布的版本。  
292 | 
293 |   “这个家伙很懒，什么都没有留下。”  
294 | 
295 | ---
296 | 
297 | #### 4.2 ImmortalWrt 固件
298 | 
299 |   源于 ImmortalWrt 社区的努力，OpenWrt 的中国版本 Fork: ImmortalWrt 与大家见面了。继承了原生 OpenWrt 的优点，加入了中国版本的特殊优化以及更多的软件和驱动支持。并且支持软件源以及固件选择器，可以支持在线 imagebuilder，对 NanoPi R2S 的支持做出了关键性的贡献。  
300 |   源码地址：[immortalwrt/immortalwrt](https://github.com/immortalwrt/immortalwrt)  
301 |   下载地址/固件选择器：[FirmWare-Selector](https://firmware-selector.immortalwrt.org/)  
302 | 
303 |   如遇到使用或安装问题，请加入 Telegram [NanoPi R4S Club](https://is.gd/nanopi_r4s) 群咨询。  
304 | 
305 | ---
306 | 
307 | #### 4.3 FriendlyWrt 固件
308 | 
309 |   已不推荐使用，内容已删除。 
310 | 
311 | ---
312 | 
313 | #### 4.4 Armbian 固件
314 | 
315 | * 地址：[Armbian/nanopi-r2s](https://www.armbian.com/nanopi-r2s/)  
316 | 
317 | ---
318 | 
319 | #### 4.5 其它 Linux 发行版固件
320 | 
321 | * OpenSuSE 等固件，通常支持的阶段非常初级，通常 r8153 的网卡不可用。  
322 | 
323 | ---
324 | 
325 | #### 4.5 NanoPi R2S 在线升级 / 降级 / 更改固件  
326 | 
327 | ##### 4.5.1 使用 LuCI 网页管理界面的"备份/升级"功能更新固件
328 | 
329 |   LuCI 管理页面，进入"系统-备份/升级"，选择刷写新的固件，上传要刷写的固件应是 .img.gz 或 .img 格式。  
330 | 
331 |   请自行核对 MD5 值和 SHA256 值确保文件一致性，选择"刷写固件"，R2S 会更新系统并且会自行重启。  
332 | 
333 |   *<注意！如果是使用 SquashFS 格式的固件，由于 TLC 类型 TF 卡的擦写缺陷，即使选择“不保存配置“仍然会保存配置(使用 EXT4 格式固件，或使用 MLC TF 卡及 TF 卡转 emmc 的除外)>*  
334 |  
335 |   如果是使用普通市售 TLC 类型 TF 卡，建议升级完成重启后，使用SSH进一步清除旧配置：  
336 | 
337 |   ```shell  
338 |   firstboot -y && reboot now
339 |   ```
340 | 
341 |   *<注意！ TLC 类型 TF 卡，无论是使用读卡器写卡刷入固件还是在线更新固件，当使用 SquashFS 格式固件时，如出现不能正常启动、或旧配置文件没能清理导致无法正常运作。请反复尝试或写入其它大文件或换用 EXT4 格式固件消除擦写缺陷>*  
342 | 
343 | ##### 4.5.2 命令行下更新固件  
344 | 
345 |   前提：
346 | 
347 | > 1. 熟悉简单 SSH 命令行操作  
348 | >
349 | > 2. 通过 scp、sftp 或“文件传输”（部分固件有编译此应用，管理页面“系统 - 文件传输”）等方式，把 .img 或 .img.gz 格式固件上传至 R2S ，例如放在 /tmp 目录下。  
350 | 
351 |   直接使用 dd 命令把固件 img 全新写入TF卡更新系统，"/dev/mmcblk0" 是 R2S 的 TF 卡设备位置，将 <openwrt.img.gz> 替换成实际文件名（不包括 <> 括号）。  
352 | 
353 |   ```shell  
354 |   dd if=/tmp/<openwrt.img> of=/dev/mmcblk0 conv=fsync
355 |   reboot
356 |   ```
357 | 
358 |   使用内置的 sysupgrade 命令：  
359 | 
360 |   ```shell  
361 |   sysupgrade -v /tmp/<openwrt.img.gz>
362 |   reboot
363 |   ```
364 | 
365 |   等待重启后，重连 SSH，输入：  
366 | 
367 |   ```shell  
368 |   firstboot -y && reboot now
369 |   ```
370 |   
371 | ##### 4.5.3 从FriendlyWrt 或其他系统升级到 OpenWrt
372 | 
373 |   建议使用 dd 命令进行写盘，参考上一条 4.5.2  
374 | 
375 |   ```shell  
376 |   dd if=/tmp/upload/<openwrt.img> of=/dev/mmcblk0 conv=fsync
377 |   reboot
378 |   ```
379 |   
380 | ---
381 | 
382 | #### 4.6 常见问题
383 | 
384 | * Q: 开机后网口灯亮，分配不到 IP / 分配到 169.254.x.x ？  
385 |   A: 确认您刷的固件插入正确的网口，如正确，手动分配子网内 IP，若可以进入后台，恢复到出厂设置（执行重置），进行干净部署。若未解决，进行换网口操作。  
386 | 
387 | * Q: 固件开启 BBR 加速了吗？  
388 |   A: BBR 不建议打开，仅对于上传有效。且会造成长链接无法再提速的问题。部分固件内置了 BBR2 来解决此问题，通常情况下建议使用 Cubic 流控。  
389 | 
390 | * Q: Flow 加速 / 软件流量分载 / Shortcut-FE 加速要开吗？  
391 |   A: Flow Offloading 建议打开，通常固件默认打开。Shortcut-FE 是从旧高通搬运到如今的新内核上，会造成kernel panic 等问题，非常不建议使用。  
392 | 
393 | * Q: HWNAT / 硬件流量分载要开吗？  
394 |   A: OpenWrt 的硬件流量分载仅支持 MTK76xx，即使勾选也没有任何意义。  
395 | 
396 | * Q: DNS 加速要开吗？  
397 |   A: 如你的网络可以正常解析 DNS，非必要情况下无需开启；此项功能可能会与 AdGuardHome、SmartDNS 等发生冲突，请注意。  
398 | 
399 | * Q: FullCone NAT 哪里开？可以开吗？  
400 |   A: 在 “网络 - 防火墙 - FullCone” 打开，建议打开。部份固件安装有 Turbo ACC 应用，可打开检查。某些主题可能存在显示项兼容性问题，可在防火墙的 WAN 口设置里打开。此外 xt_fullcone 对 TCP 和 UDP 均有效，但是对于需要耗尽状态表的用户建议开启从 Asuswrt-Merlin 上搬运来的 BCM_fullcone，仅对 UDP 有效。  
401 | 
402 | * Q: 类原生固件可以使用 sysupgrade 吗？  
403 |   A: 可以上传 img.gz 文件在线升级，不建议保留配置。RootFS 相同的固件，使用 TLC 类型 TF 卡，可能存在选择“不保存配置”升级也是保存配置，参考 2.2.3 条目。  
404 | 
405 | * Q: 建议使用备份吗？  
406 |   A: 如果你长期使用某一个人的版本，且未有重大更新，建议保留配置直接升级。跨版本升级请尽量干净部署。  
407 | 
408 | * Q: 为什么更改不了 LAN IP / 管理地址？  
409 |   A: 这是 OpenWrt 从 19.07 以来的新 Feature，用于误操作失效后自动回滚。可点击保存并应用旁边向下的箭头，选择“强制应用”，或参考 5.2.2 条目。  
410 | 
411 |   **其他问题请先学会善用 [搜索引擎](https://www.google.com/)，尝试自行解决，对于无法自行解决的问题欢迎阅读 [提问的艺术](https://github.com/betaseeker/How-To-Ask-Questions) 后在 Telegram 群 [NanoPi R4S Club](https://is.gd/nanopi_r4s) 中提出、讨论。**  
412 | 
413 | ---
414 | 
415 | ### 5、OpenWrt 使用基本介绍
416 | 
417 | #### 5.1 OpenWrt基本知识整理
418 | 
419 |   假若有意了解 OpenWrt，可参阅佐须之男的 [OpenWrt 知识整理](http://www.openwrt.pro/post-170.html)
420 | 
421 | #### 5.2 SSH 操作
422 | 
423 |   使用者应具备一点最基础的系统操作能力，例如学会一点 SSH 操作
424 | 
425 | ##### 5.2.1 SSH 客户端的下载及连接
426 | 
427 | > Windows 用户：下载 [putty](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)  
428 | >
429 | > Linux / macOS 用户：终端输入：  
430 | 
431 |   ```shell  
432 |   ssh -p <你的 DropBear 端口号，默认为 22> root@<你的 R2S 的 IP 地址>
433 |   ```
434 | 
435 |   *<注意，去掉 <> 括号，建议修改端口号为非 22，LAN Only 。输入密码不会有任何回显。 OpenWrt 缺省只有 root 一个用户>*  
436 | 
437 | ##### 5.2.2 SSH 的基本操作
438 | 
439 | * 更改 LAN IP  
440 | 
441 |   ```shell
442 |   uci set network.lan.ipaddr=<新的 LAN 地址>
443 |   uci commit network
444 |   /etc/init.d/network restart
445 |   ```
446 |   
447 |   *<注意，不包括 <> 括号。>*
448 |   
449 | * 使用 vi / vim 命令  
450 | 
451 |   [vi / vim 命令教程](https://www.runoob.com/linux/linux-vim.html)  
452 | 
453 |   例如:
454 |   
455 |   ```shell  
456 |   vim /etc/config/network
457 |   /etc/init.d/network restart
458 |   ```
459 | 
460 |   *<换网口 ETH，改 WAN 口、LAN 口配置，更改 MAC 地址等均可通过 network 文件更改，希望大家举一反三，一通百通>*  
461 | 
462 | * 使用 SSH 查看设备温度  
463 | 
464 |   ```shell    
465 |   cat /sys/class/thermal/thermal_zone0/temp
466 |   ```
467 | 
468 | * 使用 SSH 查看设备 Soc 频率  
469 | 
470 |   ```shell  
471 |   cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_cur_freq
472 |   ```
473 | 
474 | * 使用 cputemp.sh 脚本查看温度频率  
475 |          
476 |   下载脚本到 /bin 路径下：  
477 | 
478 |   ```shell  
479 |   wget https://raw.githubusercontent.com/nicholas-opensource/OpenWrt-Autobuild/main/PATCH/script/cputemp.sh -O /bin/cputemp.sh
480 |   ```
481 | 
482 |   使用脚本： 
483 |   
484 |   ```shell
485 |   chmod +x /bin/cputemp.sh
486 |   /bin/cputemp.sh
487 |   ```
488 |   或者
489 |   ```shell  
490 |   sh /bin/cputemp.sh
491 |   ```
492 | 
493 |   退出使用 `Ctrl + C`  
494 | 
495 | ---
496 | 
497 | ## 未完待续，欢迎补充！
498 | 


--------------------------------------------------------------------------------
/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="zh">
 3 | <head>
 4 |   <meta charset="UTF-8">
 5 |   <title>R2S Wiki</title>
 6 |   <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
 7 |   <meta name="R2S Wiki" content="R2S Guidebook of Beginners">
 8 |   <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
 9 |   <!-- 支持夜间模式的主题 -->
10 |   <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify-darklight-theme@latest/dist/style.min.css" title="docsify-darklight-theme"/>
11 | </head>
12 | <body>
13 |   <div id="app"></div>
14 |   <script>
15 |     window.$docsify = {
16 |       name: 'NanoPi-R2S 操作手册',
17 |       repo: 'https://github.com/nicholas-opensource/R2S-Wiki',
18 | 
19 |       // 切换页面后自动跳转到页面顶部
20 |       auto2top: true,
21 | 
22 |       // 搜索
23 |       search: {
24 |         paths: ['/'],
25 |         placeholder: '搜索',
26 |         noData: '没有找到结果',
27 |         hideOtherSidebarContent: true,
28 |         depth: 6
29 |       },
30 | 
31 |       // 复制代码
32 |       copyCode: {
33 |         buttonText: '复制到剪贴板',
34 |         errorText: '复制失败',
35 |         successText: '复制成功'
36 |       }
37 |     }
38 |   </script>
39 |   <!-- Docsify v4 -->
40 |   <script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
41 |   <!-- 搜索 -->
42 |   <script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
43 |   <!-- 复制代码 -->
44 |   <script src="//cdn.jsdelivr.net/npm/docsify-copy-code/dist/docsify-copy-code.min.js"></script>
45 |   <!-- Bash 语法高亮 -->
46 |   <script src="//cdn.jsdelivr.net/npm/prismjs/components/prism-bash.min.js"></script>
47 |   <!-- 支持夜间模式的主题 -->
48 |   <script src="//cdn.jsdelivr.net/npm/docsify-darklight-theme@latest/dist/index.min.js"></script>
49 | </body>
50 | </html>
51 | 


--------------------------------------------------------------------------------
/others/ask-a-question.md:
--------------------------------------------------------------------------------
 1 | ## How to ask a question in Telegram group NanoPi R2S Club  
 2 | 
 3 | * __如何在Telegram群[NanoPi R2S Club](https://t.me/nanopir2sshell)里提问__  
 4 | 
 5 |   > 先确定您所遇到的问题没有在 [Wiki](https://github.com/nicksun98/R2S-Wiki/blob/master/README.md) 中包含。  
 6 |   
 7 |   等一下！您真的确认吗？这不是啰嗦，Wiki 中包含各种R2S的冷知识，比如为什么不能启动，怎么刷卡，Ext4 和 SquashFS 的区别等各种奇怪问题，请您认真确认一遍。  
 8 | 
 9 | 
10 | 


--------------------------------------------------------------------------------
/others/friendlywrt.md:
--------------------------------------------------------------------------------
 1 |   FriendlyWrt 固件基于 [友善官方源码](https://wiki.friendlyarm.com/wiki/index.php/How_to_Build_FriendlyWrt/zh) 和 开源社区 的努力。来自 Armbian 内核 和 OpenWrt 主线源码 杂交而成。存在防火墙阻断 IPv4 流量，WAN 口不能重播，Crontab 等各种问题，可以靠脚本守护。  
 2 | 
 3 |  * 1、友善官方固件  
 4 | 
 5 |     * 官方固件，[下载地址](http://download.friendlyarm.com/nanopir2s)  
 6 | 
 7 |   * 1.2、来自开源社区的友善固件  
 8 | 
 9 |       Dayong  
10 |       地址：[klever1988/nanopi-openwrt](https://github.com/klever1988/nanopi-openwrt)  
11 |       
12 |       Chuck（已弃）  
13 |       地址：[fanck0605/nanopi-r2s](https://github.com/fanck0605/nanopi-r2s)  
14 |       
15 |       Song Chenwen  
16 |       地址：[songchenwen/nanopi-r2s](https://github.com/songchenwen/nanopi-r2s)  
17 |       
18 |       RT（过于古早）  
19 |       地址：[Telegram @R2Spasswall](https://t.me/R2Spasswall)  
20 |       
21 |       eSir（过于古早）  
22 |       地址：https://drive.google.com/drive/folders/1DPy8lXhg2btbHsTvpUGVZF2k1rmT7DXA  
23 | 
24 |  * 2、在线升级固件  
25 | 
26 |     * 部分固件内置有 SongChenwen 大佬的 [luci-app-r2sflasher](https://github.com/songchenwen/nanopi-r2s/tree/master/luci-app-r2sflasher)，可实现图形化刷机。  
27 | 
28 |     * 或者使用 Gary 大佬的在线刷机脚本：  
29 |     ```shell  
30 |     wget -q https://github.com/quintus-lab/Openwrt-R2S/raw/master/script/update.sh && sh ./update.sh
31 |     ```  
32 |        *<脚本 3 4 选项的 ardanzhu 固件链接已失效>*  
33 | 


--------------------------------------------------------------------------------