ubuntu编译小智AI面包板esp32s3n16r8

作者：Harrandi 发布时间：May 16, 2026 分类：Linux

1.安装依赖

sudo apt update
sudo apt install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build    ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

2.克隆新版本

cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
git checkout v5.5.4
git submodule update --init --recursive

3. 安装工具链

./install.sh

4. 设置环境变量（每次新终端需要执行）

. ./export.sh

5. 验证版本

idf.py --version

未来升级

1. 进入旧版 IDF 目录（根据你的实际路径）

cd ~/esp/esp-idf

2. 切换到 v6.x.x

git fetch --all
git checkout v6.x.x
git submodule update --init --recursive

3. 清理并重新安装工具

rm -rf ~/.espressif   # 删除旧工具链
./install.sh

4. 重新设置环境

. ./export.sh

5. 验证

idf.py --version

编译

设置环境（每次新终端都要执行）

source ~/esp/esp-idf/export.sh

或者

cd ~/esp/esp-idf
. ./export.sh

配置开发板型号

idf.py set-target esp32s3   # 改成你的芯片型号

打开配置菜单（选择 Board Type）

idf.py menuconfig

进入 Xiaozhi Assistant → Board Type → 选择你的开发板

编译

idf.py build

烧录（连接开发板后）

idf.py -p /dev/ttyUSB0 flash

查看串口日志（可选）

idf.py -p /dev/ttyUSB0 monitor

记一次出错：
“ - no versions of espressif2022/image_player match ==1.1.0~1

  - project depends on espressif2022/image_player (==1.1.0~1)  ”

解决方法：

找到并打开 main/idf_component.yml

将 espressif2022/image_player: ==1.1.0~1 改为 espressif2022/image_player: ^1.1.1

将 espressif2022/esp_emote_gfx: ==1.0.0~2 改为 espressif2022/esp_emote_gfx: ^1.2.0

重新编译：

rm -rf build managed_components
idf.py fullclean
idf.py build

部署小智AI到公网

作者：Harrandi 发布时间：May 14, 2026 分类：Linux

记录一下，也或许有人用得到。
参考https://github.com/xinnan-tech/xiaozhi-esp32-server/issues/791

1.克隆项目，https://github.com/xinnan-tech/xiaozhi-esp32-server
参考文件夹docs内的Deployment_all.md,
xiaozhi-esp32-server-redis和voiceprint-api我使用了docker其余没 用.
先搞定本地的部署，测试正常后配置公网。
2.去CF增加一个A记录如xiaozhi，地址填当前你服务器公网地址然后获取域名ID（不是ZONE ID）后面用得到：

curl --request GET   --url "https://api.cloudflare.com/client/v4/zones/你的ZONE ID/dns_records?name=xiaozhi.yours.org&type=A"   --header "Authorization: Bearer 你的APItoken"   --header "Content-Type: application/json"

为域名申请letsencrypt证书：
略麻烦，因为我用动态域名，我也尝试了tunnel，工作不正常，只能用动态域名+直接开放端口。
登录 Cloudflare 控制台，进入 My Profile → API Tokens
点击 Create Token → 选择 Create Custom Token
配置权限（如Zone Zone Read; Zone DNS Edit）
选择Specific zone，即要用的域名.
在 TTL (time to live) 区域设置：
Start date (notBefore)：可选，设置 Token 何时开始生效。不填则创建后立即生效
End date (notAfter)：建议设置，Token 到此时间后自动失效。不填则永不过期

用 DNS-01 申请 SSL 证书：
# 安装 certbot 和 cloudflare dns 插件

sudo apt install certbot python3-certbot-dns-cloudflare

# 创建 API Token 配置文件（把 TOKEN 换成你的）

echo 'dns_cloudflare_api_token = 你的CloudflareAPIToken' | sudo tee /etc/cloudflare.ini
sudo chmod 600 /etc/cloudflare.ini

# 申请证书

sudo certbot certonly \
 --dns-cloudflare \
 --dns-cloudflare-credentials /etc/cloudflare.ini \
 -d xiaozhi.yours.org

创建一个动态IP更新脚本命名cf-ddns.sh：

#!/bin/bash
# ===配置区=============
CLOUDFLARE_API_TOKEN="你的APItoken"
ZONE_ID="你的ZoneID"
DNS_RECORD_ID="你的域名ID"
DNS_RECORD_NAME="xiaozhi.yours.org"
DNS_RECORD_TYPE="A"
# =====下方无需改动======

# curl 和 jq 的完整路径（cron 需要,没有的话需要安装）
CURL="/usr/bin/curl"
JQ="/usr/bin/jq"

# 获取当前公网 IP
IP=$($CURL -s ifconfig.me)

# 获取 Cloudflare 上当前记录的 IP
CURRENT_IP=$($CURL -s -X GET    "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/$DNS_RECORD_ID" \
 -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
 -H "Content-Type: application/json" | $JQ -r '.result.content')

# 比较是否需要更新
if [[ "$IP" == "$CURRENT_IP" ]]; then
echo "$(date): IP 未变化，跳过更新 ($IP)"
exit 0
fi

# IP 变化了，执行更新
echo "$(date): IP 从 $CURRENT_IP 变为 $IP，开始更新..."

$CURL -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/$DNS_RECORD_ID" \
 -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
 -H "Content-Type: application/json" \
 --data '{
   "type": "'"$DNS_RECORD_TYPE"'",
   "name": "'"$DNS_RECORD_NAME"'",
   "content": "'"$IP"'",
   "ttl": 120,
   "proxied": false
 }'

 echo "$(date): 更新完成 -> $IP"

将这个脚本加入cron并输出日志注意权限：

chmod +x ~/cf-ddns.sh        # 给执行权限
crontab -e                       # 编辑定时任务

*/5 * * * * /yourpath/cf-ddns.sh >> /home/you/ddns-error.log

3.配置Nginx反代，参考顶部链接内的服务器基础参数。
我的根目录是智控台(必须，我尝试子目录访问总是有小问题)，digital-human就是之前的测试页面，为方便使用digital-human所以全部使用https,如需保留http删除nginx配置第一块sever_name下的return行。

登陆修改智控台内server.fronted_url为
https://xiaozhi.yours.org:8443，
server.websocket 地址wss://xiaozhi.yours.org:8443/xiaozhi/v1/
OTA地址 https://xiaozhi.yours.org:8443/xiaozhi/ota/
部署web：

cd ~/xiaozhi-esp32-server/main/manager-web
npm run build
cp -r dist/* /var/www/manager-web/

权限设置：

sudo chown -R www-data:www-data /var/www/manager-web
sudo find /var/www/manager-web -type d -exec chmod 755 {} \;
sudo find /var/www/manager-web -type f -exec chmod 644 {} \;

# 重载 Nginx
nginx -s reload

我的nginx配置：

server {
listen 8080 ;
server_name yours.org;
return 301 https://$host:8443$request_uri; #如使用http删除此行
  location / {
    root /var/www/manage-web;
    index index.html index.htm;
    try_files $uri $uri/ =404;
}

 location /xiaozhi/v1/ {
    proxy_pass http://192.168.10.12:8000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
  location /xiaozhi/ota/ {
    proxy_pass http://192.168.10.12:8002;
    proxy_http_version 1.1;

    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

}
server {
listen 8443 ssl;
server_name yours.org;

ssl_certificate /etc/letsencrypt/live/xiaozhi.yours.org/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/xiaozhi.yours.org/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
    
  location / {
    root /var/www/manager-web/;
    index index.html;
    try_files $uri $uri/ =404;
}

  location /digital-human {
    root /var/www/;     
    index index.html index.htm;     
    try_files $uri $uri/ =404;
}   



 location /xiaozhi/v1/ {
    proxy_pass http://192.168.10.12:8000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_read_timeout 3600s;
}
  location /xiaozhi/ota/ {
    proxy_pass http://192.168.10.12:8002;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
  location /xiaozhi/ {
    proxy_pass http://127.0.0.1:8002;
    proxy_set_header Host $host;
    proxy_connect_timeout 15;
    proxy_send_timeout 15;
    proxy_read_timeout 15;
    proxy_set_header   X-Real-IP  $remote_addr;
    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
} 
}

因为我三个组件不是docker部署，所以用systemctl管理：
打包manager-api：

# 进入 manager-api 项目根目录（有 pom.xml 的地方）
cd /path/to/manager-api

# 用 Maven 打包
mvn clean package -DskipTests

创建systemctl：

sudo nano /etc/systemd/system/manager-api.service

[Unit]
Description=Xiaozhi Manager API Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/home/yours/xiao-zhi-server/main/manager-api
ExecStart=/usr/bin/java -jar /home/yours/xiao-zhi-server/main/manager-api/target/xiaozhi-esp32-api.jar
Restart=always
RestartSec=10
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target

创建SERVER的systemctl：

[Unit]
Description=Xiaozhi ESP32 Server
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/home/yours/xiao-zhi-server/main/xiaozhi-server
ExecStart=/home/yours/miniconda3/envs/xiaozhi-esp32-server/bin/python app.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

创建MCP的systemctl：

[Unit]
Description=Xiaozhi MCP Server Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/home/yours/xiao-zhi-server/mcp-endpoint-server
ExecStart=/home/yours/miniconda3/envs/mcp-endpoint-server/bin/python main.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启动或查询或自动它们：

sudo systemctl daemon-reload
sudo systemctl start 服务名
sudo systemctl enable 服务名
sudo systemctl status 服务名

Octo4a 安装klipper+moonraker+mainsail

作者：Harrandi 发布时间：May 13, 2026 分类：arduino

首先安装app,保正网络畅通。
运行后点击齿轮，最上方的安装plugin extras点一下等它装好。
然后最下方第三个Extensions，开启Remote web terminal(ttyd)
如果你想用齿轮那页的dropbear ssh也可以
最下方server，也就是首页，octoprint点下运行，成功后会出现ip地址，默认端口号5000
这时打开浏览器，输入这个ip地址但是端口号是5002,登陆，用户名root，密码可能是octoprint，或者是齿轮页你修改的dropbear里那个SSH密码
登录后，先wget 两个脚本
https://github.com/feelfreelinux/octo4a/raw/refs/heads/master/scripts/setup-octo4a.sh
https://github.com/feelfreelinux/octo4a/raw/refs/heads/master/scripts/setup-klipper-moonraker.sh

然后分别运行它们 bash -x your_script.sh 2>&1 | tee script.log
就搞定了。有错误可以阅读script.log

首页的USB连接一般选择 CDC 方式，比如我是连接bigtree的打印板。

The Computers I have used

作者：Harrandi 发布时间：May 13, 2026 分类：随便写写,微心情

记录一下。以免哪天想不起来了。
第一个电脑
升技sa6 815ep 赛扬900 金邦金条 ibm40g NV GeForce 2 mx400?
第二个电脑
技嘉nf2换升技 紫巴顿2500+ OC 3200 盈通 ati9550
第三个电脑
升级ib9 酷睿2 2140或2160 蓝宝石Ati1950pro
升技p45deluxe Q8200 nv gt730
技嘉B75D3H 志强E3 1230 v2 orv3? nv Gtx950
第六个电脑
技嘉b450i amd ryzen2 3600 ati 5500xt & NV 2800Ti

Laptops

Dell D630 T7250 nv 显卡
X13 gen2a 5850U

Nuc
技嘉nuc pentium Gold 5005

ArmSBs
Raspberry 1B 2B 3 ZeroW
Radxa Zero3W