基于树莓派3B+平台的可道云搭建（不少的坑）

树莓派现在都出到4代了，3B+在家已经吃灰很久了，想到这么一台低功耗设备，应该比较适合做下载机或者NAS，本着折腾的精神，就拿出来搞搞。

树莓派适合折腾的点在于，硬件高度整合，需要折腾的其实就是那一个内存卡（TF卡），现在树莓派的官网上，烧录工具已经升级迭代的比较完美了，感觉不需要其他什么第三方软件了。

官网下载地址（烧录工具）：树莓派官网下载

Raspberry Pi Imager 就是烧录工具

镜像的话，因为考虑到功耗和我们主要使用SSH操作树莓派，且功能都在网页端实现，所以选择lite版本的无桌面系统。

考虑到兼容性，我下载了32位的lite镜像，后面可道云安装时候建议是64位的，但查了区别，说树莓派3B+这点儿小内存，64位的效率反而低。 可道云如果在32位系统上搭建，有一个限制要注意，单个文件不得超过2GB,，如果要存大文件的，建议使用64位的镜像。

树莓派os镜像的下载地址是：树莓派系统官网下载

我使用的镜像是：Raspberry Pi OS Lite (Legacy)

烧录树莓派系统较为简单，也就是把TF卡插入读卡器，然后接到电脑上，使用树莓派imager工具先选择擦除，然后选择自定义镜像，选择下载的镜像，别忘了设置基本参数（Imager右下方的齿轮），比如用户名，密码，打开SSH，WiFi名称和密码等等，选择永久保存参数，以后再烧录的时候就可以不用重复设置了。

设置参数的好处是，烧录完成后的内存卡，插入树莓派设备后，启动后，自动联网，且打开SSH，我使用Putty工具连接树莓派命令行并操作。

输入用户名、密码后，连上了树莓派，第一件事就是众所周知的更新apt软件源，我这里就不赘述了，网上一大堆。最后sudo apt update;sudo apt upgrade完成更新。

然后就是搭建基础环境了，我考虑到树莓派平台的承载能力，选择Nginx+PHP的搭配，数据库因为可道云支持SQLite，所以考虑到MySQL还是有负载的，所以省去了数据库。

搭建的顺序是先搞定PHP，然后搭建Nginx，然后做好Nginx的设置，以支持PHP的运行。

我考虑到树莓派3B+的承载力，选择了PHP7.3版本，在命令行输入命令即可安装：

第一步是安装主体：sudo apt install php7.3

第二步是安装模块（可道云会检查所需模块）：sudo apt install php7.3-fpm php7.3-common php7.3-cli php7.3-curl php7.3-gd php7.3-json php7.3-mbstring php7.3-mysql php7.3-xml

第三步是启动php服务，命令行运行 sudo /etc/init.d/php5-fpm start

如果安装可道云时候提醒还缺少什么模块，就在命令行安装相应的模块，然后重启Nginx即可。

安装完php7.3后，可以通过查看版本号来验证是否正确安装。命令行输入php -v 进行查看。

搞完php，接下去搞Nginx。

安装Nginx不难，就是命令行输入 sudo apt install nginx 等待安装完成即可。

安装完成后，在浏览器输入树莓派IP，即可打开Nginx的欢迎页。

我的难点在于配置Nginx运行php网页。

配置Nginx的文件在/etc/nginx/sites-available/default

通过命令行运行 sudo nano /etc/nginx/sites-available/default 编辑默认配置

在location /{}块中，找到index index.html这一行，加入index.php

在location ~ \.php$[]块中，取消location前的注释号#，以及取消以下几行的注释符号#

include snippets/fastcgi-php.conf;

fastcgi_pass unix:/run/php/php7.3-fpm.sock;

最后别忘了 ] 符号前面的# 要去除。

然后Ctrl+O，回车保存文件，Ctrl+X退出编辑。

回到命令行后，使用 nginx -t 检查一下配置文件是否正确。

然后重新加载Nginx服务器配置，使得php生效。

命令行输入 sudo /etc/init.d/nginx reload

放一个php文件在网页文件夹下，我的文件夹是/var/www/html

我的index.php文件内容是：

<?php

        phpinfo();

?>

然后在浏览器中输入 树莓派IP/index.php 打开看看能不能展示php的系统信息页面，能显示就正常了，不能显示就再百度解决问题。

最后一个环节了，部署可道云网站源码。可道云的官网是：可道云官网下载

在/var/www/html目录下面 sudo mkdir kodbox新建一个目录专门给可道云使用

cd kodbox目录，然后下载安装可道云。

在官网右侧有说linux命令行下载安装脚本，涉及到unzip这个工具，系统默认没有，先在命令行下载安装 sudo apt install unzip

然后将官网中的下载安装命令一股脑贴到命令行中运行。

第一部分是下载可道云源码压缩包

sudo wget https://static.kodcloud.com/update/download/kodbox.1.42.zip

第二部分是解压压缩包并修改所有目录的读写权限
unzip kodbox.1.42.zip && chmod -Rf 777 ./*

完成后，浏览器登录 树莓派IP/kodbox/index.php 进入安装页面，首先会自动检查安装条件，是否缺什么模块啦，是否目录权限设置有问题啦等等。我这边给出的建议是使用64位系统，不予理睬。直接跳过，下一步。

下一步就是选择数据库类型和系统缓存类型，我都是默认，数据库是SQLite，系统缓存类型为文件缓存，作为家庭轻度使用，我觉得也凑合了。

下一步是设置管理员用户密码，用户名默认是admin（可修改），密码自己设置，建议记在小本本上，以免遗忘。

完成后，就登录进入可道云了，后续使用较为简单，不再赘述。

欢迎交流。