https://www.luochang.ink/tags/raspberry-pi/ Recent content in Raspberry Pi on Chang Luo Hugo zh-CN Sun, 18 Jan 2026 00:00:00 +0000 https://www.luochang.ink/posts/rpi_agent_server/ Sun, 18 Jan 2026 00:00:00 +0000 https://www.luochang.ink/posts/rpi_agent_server/ <blockquote> <p>使用树莓派搭建 <a href="https://github.com/luochang212/dive-into-langgraph/tree/main/app">dive-into-langgraph/app</a> 服务，在家庭局域网内部使用。</p> </blockquote> <p>一键部署脚本：<a href="https://github.com/luochang212/agent-server">agent-server</a></p> <h3 id="一制作-tf-卡">一、制作 TF 卡</h3> <blockquote> <p><strong>Note:</strong> 你可以参考我的这篇博客《<a href="https://www.luochang.ink/posts/raspberry_pi_5/">树莓派 5 装机指南</a>》，它写得更详细一些。但部分信息已经过时，请注意甄别。</p> </blockquote> <h4 id="1下载">1）下载</h4> <p>你需要下载两样东西：</p> <ul> <li><a href="https://www.raspberrypi.com/software/">Raspberry Pi Imager</a>：将镜像写入 TF 卡的工具</li> <li><a href="https://ubuntu.com/download/raspberry-pi">Ubuntu 24.04.3 LTS</a>：树莓派的 Ubuntu 镜像</li> </ul> <p>Ubuntu 镜像有两种版本：桌面版、服务器版，我们下载服务器版。下载的时候可以检查一下，安装包的文件名应该是这个 <code>ubuntu-24.04.3-preinstalled-server-arm64+raspi.img.xz</code></p> <h4 id="2将镜像写入-tf-卡">2）将镜像写入 TF 卡</h4> <p>根据 <strong>Raspberry Pi Imager</strong> 的指引，完成镜像烧录的过程就好了。并没有什么难的。唯一需要注意的是，由于我们已经下载了 Ubuntu 镜像，所以这里要选「使用自定义镜像」。</p> <p><img src="https://www.luochang.ink/img/Raspberry-Pi-Imager-2025.png" alt="image"></p> <h3 id="二首次启动-ubuntu">二、首次启动 Ubuntu</h3> <p>烧录完成后，按以下步骤操作：</p> <ol> <li>先断电，然后将 TF 卡插入板子</li> <li>连接外接显示屏、键盘、网线</li> <li>最后插入电源</li> </ol> <p>一般来讲，插电即可点亮。这时回车一下，即可输入账号密码，初始账密是：</p> <table> <thead> <tr> <th></th> <th></th> </tr> </thead> <tbody> <tr> <td>账号</td> <td>ubuntu</td> </tr> <tr> <td>密码</td> <td>ubuntu</td> </tr> </tbody> </table> <p>输完账密，它会接着让你设置新密码。这里流程设计得有点人机，需要注意看提示，不然容易卡关。温馨提示：你输入 <code>ubuntu</code> 的次数比你想象中更多。</p> <h3 id="三环境配置">三、环境配置</h3> <h4 id="1更新软件包">1）更新软件包</h4> <div class="highlight"><pre tabindex="0" style="background-color:#f7f7f7;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#57606a"># 更新软件源的索引列表</span> </span></span><span style="display:flex;"><span>sudo apt update </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#57606a"># 根据更新后的索引，升级所有可更新的软件包</span> </span></span><span style="display:flex;"><span>sudo apt upgrade -y </span></span></code></pre></div><h4 id="2安装-pipx-和-uv">2）安装 pipx 和 uv</h4> <p>先安装 <code>pipx</code>，再用它安装 <code>uv</code>：</p>