1. 为什么需要给NVIDIA Jetson Orin换源刚拿到NVIDIA Jetson Orin开发板的朋友们相信你们和我一样兴奋。但很快就会发现一个头疼的问题系统更新和软件安装慢得像蜗牛爬。这是因为默认的软件源服务器在国外国内访问速度堪忧。我刚开始用Orin时一个简单的apt update能卡上半小时有时候还会因为网络问题直接失败。这时候就该请出我们的救星——国内镜像源了。国内有多所高校和机构维护着Ubuntu的镜像服务器比如中国科学技术大学(USTC)的镜像源。这些服务器在国内访问速度飞快基本能跑满你的带宽。实测下来原来半小时的更新操作换源后可能只需要十几秒。对于Jetson Orin这样的ARM架构设备Ubuntu官方提供了专门的ports源。USTC镜像站也同步了这部分内容所以完全不用担心兼容性问题。我在多个Orin设备上都测试过从系统更新到软件安装整个过程丝般顺滑。2. 准备工作了解你的系统环境在动手修改之前我们需要先确认几个关键信息。首先打开终端输入以下命令查看系统版本lsb_release -a这个命令会输出类似这样的信息No LSB modules are available. Distributor ID: Ubuntu Description: Ubuntu 20.04.6 LTS Release: 20.04 Codename: focal重点看Codename这一行这里是focal说明我们用的是Ubuntu 20.04 LTS版本。这个信息很重要因为后续的软件源配置都要对应这个版本代号。接着确认设备架构uname -m对于Jetson Orin这里应该显示aarch64表示是ARM64架构。这也是为什么我们要用ubuntu-ports源而不是普通的ubuntu源。最后检查下当前源的状态sudo apt update记下更新速度和各种报错信息等换源后再对比你会明显感受到差别。我第一次做这个对比测试时更新速度从原来的300KB/s直接飙升到10MB/s效果立竿见影。3. 详细换源步骤手把手教学现在进入正题教大家如何把官方源替换成USTC镜像源。整个过程分为备份、修改、更新三个步骤我会详细说明每个环节的注意事项。3.1 备份原有源列表安全第一修改前一定要先备份。这个习惯帮我躲过了无数次灾难。执行以下命令sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak这样就算改错了也能随时恢复。我建议再把这个备份文件拷贝到home目录下cp /etc/apt/sources.list.bak ~/双重保险更放心。有一次我不小心把sources.list清空了多亏有这个备份否则就得重装系统了。3.2 修改sources.list文件用nano编辑器打开源文件sudo nano /etc/apt/sources.list把文件内容全部删除替换为以下内容deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal main restricted universe multiverse deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-updates main restricted universe multiverse deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-backports main restricted universe multiverse deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-security main restricted universe multiverse注意几点每行开头的deb表示二进制包deb-src是源代码包一般开发用不到我就注释掉了[archarm64]明确指定了ARM64架构focal要和你系统的Codename一致USTC的镜像地址是https协议更安全修改完成后按CtrlO保存CtrlX退出。建议再用cat命令检查下文件内容cat /etc/apt/sources.list确保没有输错任何字符。我曾经因为少写了一个字母s把https变成http结果导致后续更新失败排查了好久才发现。3.3 更新软件包列表最后执行更新sudo apt update这个命令会从新的镜像源获取最新的软件包信息。正常情况下你应该能看到速度明显提升而且没有报错。如果出现Failed to fetch之类的错误可能是网络问题可以尝试检查网络连接确认镜像地址是否正确暂时关闭防火墙测试更新完成后可以升级已安装的软件包sudo apt upgrade这一步不是必须的但建议定期执行保持系统最新。我一般每周做一次完整更新确保安全补丁都能及时打上。4. 验证与常见问题排查换源完成后我们需要验证是否真的生效了。这里分享几个实用技巧和常见问题的解决方法。4.1 如何确认正在使用USTC源执行apt update时注意看输出的URL。你应该能看到mirrors.ustc.edu.cn的字样Get:1 https://mirrors.ustc.edu.cn/ubuntu-ports focal InRelease [265 kB] Get:2 https://mirrors.ustc.edu.cn/ubuntu-ports focal-updates InRelease [114 kB] ...更直观的方法是测速。安装speedtest-clisudo apt install speedtest-cli speedtest对比换源前后的下载速度。我在北京测试USTC源的下载速度能到50Mbps以上而官方源经常不到1Mbps。4.2 常见错误及解决方案问题1证书验证失败错误信息可能包含Certificate verification failed。这是因为有些老系统没有更新CA证书。解决方法sudo apt install ca-certificates sudo update-ca-certificates问题2404 Not Found如果看到404错误可能是版本代号写错了。比如把focal写成了bionic。仔细检查lsb_release -a的输出确保一致。问题3速度仍然很慢可能是DNS问题。尝试修改/etc/resolv.conf使用公共DNSnameserver 8.8.8.8 nameserver 114.114.114.114然后重启网络服务sudo systemctl restart systemd-networkd4.3 其他实用技巧如果你想换回官方源直接恢复之前的备份即可sudo cp /etc/apt/sources.list.bak /etc/apt/sources.list sudo apt update对于需要特定软件的情况可以单独添加PPA源。比如要安装最新版的GCCsudo add-apt-repository ppa:ubuntu-toolchain-r/test sudo apt update sudo apt install gcc-12定期清理旧的软件包节省空间sudo apt autoremove sudo apt clean我在Jetson Orin上开发时发现存储空间很宝贵。定期清理可以避免空间不足的问题。5. 进阶配置优化APT性能基础换源完成后还可以进一步优化APT的性能和使用体验。这些技巧都是我在实际项目中总结出来的能显著提升开发效率。5.1 配置APT缓存代理如果你有多台Jetson设备可以设置APT缓存代理避免重复下载。安装apt-cacher-ngsudo apt install apt-cacher-ng sudo systemctl enable apt-cacher-ng然后在其他设备的/etc/apt/apt.conf.d/02proxy文件中添加Acquire::http::Proxy http://代理服务器IP:3142;这样所有软件包只需要下载一次后续安装都会从本地缓存获取。我在实验室部署了10台Orin设备用这个方法节省了90%的带宽。5.2 选择性更新源有时候我们只需要安全更新可以注释掉其他源只保留security# deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-updates main restricted universe multiverse # deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-backports main restricted universe multiverse deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-security main restricted universe multiverse这样apt update会更快适合对稳定性要求高的生产环境。5.3 使用apt-fast加速下载apt-fast是apt的并行下载工具能大幅提升大文件的下载速度。安装方法sudo add-apt-repository ppa:apt-fast/stable sudo apt update sudo apt install apt-fast使用时只需把apt换成apt-fastsudo apt-fast install tensorrt实测下载大型AI框架时速度能提升3-5倍。特别是在网络状况复杂的环境下效果更明显。6. 开发环境配置建议换源只是第一步要充分发挥Jetson Orin的性能还需要合理配置开发环境。这里分享一些我在AI项目中的经验。6.1 基础开发工具安装首先安装必备的开发工具sudo apt install build-essential cmake git python3-dev python3-pip对于AI开发建议安装以下软件包sudo apt install libopencv-dev libboost-all-dev libeigen3-dev这些是计算机视觉和深度学习的基础依赖库。我建议在系统初始化时就装好避免后续各种奇怪的编译错误。6.2 Python环境配置虽然系统自带Python3但建议使用虚拟环境pip3 install virtualenv virtualenv ~/venv -p python3 source ~/venv/bin/activate这样能避免污染系统Python环境。安装AI相关的Python包时建议使用USTC的PyPI镜像pip install -i https://pypi.mirrors.ustc.edu.cn/simple/ numpy torch torchvision大型框架下载速度能快10倍不止。我在安装PyTorch时官方源要1个多小时换源后5分钟就搞定了。6.3 深度学习框架选择Jetson Orin对TensorRT的支持最好建议优先考虑sudo apt install tensorrt python3-libnvinfer-dev对于PyTorch用户可以安装NVIDIA官方提供的预编译版本pip install --extra-index-url https://developer.download.nvidia.com/compute/redist/jp/v50 torch1.13.0 torchvision0.14.0注意要选择与JetPack版本兼容的框架版本。我曾经因为版本不匹配导致模型推理速度慢了50%排查了好久才发现是框架版本问题。
【NVIDIA Jetson Orin】APT换源实战:USTC镜像加速开发环境配置
发布时间:2026/5/21 18:40:11
1. 为什么需要给NVIDIA Jetson Orin换源刚拿到NVIDIA Jetson Orin开发板的朋友们相信你们和我一样兴奋。但很快就会发现一个头疼的问题系统更新和软件安装慢得像蜗牛爬。这是因为默认的软件源服务器在国外国内访问速度堪忧。我刚开始用Orin时一个简单的apt update能卡上半小时有时候还会因为网络问题直接失败。这时候就该请出我们的救星——国内镜像源了。国内有多所高校和机构维护着Ubuntu的镜像服务器比如中国科学技术大学(USTC)的镜像源。这些服务器在国内访问速度飞快基本能跑满你的带宽。实测下来原来半小时的更新操作换源后可能只需要十几秒。对于Jetson Orin这样的ARM架构设备Ubuntu官方提供了专门的ports源。USTC镜像站也同步了这部分内容所以完全不用担心兼容性问题。我在多个Orin设备上都测试过从系统更新到软件安装整个过程丝般顺滑。2. 准备工作了解你的系统环境在动手修改之前我们需要先确认几个关键信息。首先打开终端输入以下命令查看系统版本lsb_release -a这个命令会输出类似这样的信息No LSB modules are available. Distributor ID: Ubuntu Description: Ubuntu 20.04.6 LTS Release: 20.04 Codename: focal重点看Codename这一行这里是focal说明我们用的是Ubuntu 20.04 LTS版本。这个信息很重要因为后续的软件源配置都要对应这个版本代号。接着确认设备架构uname -m对于Jetson Orin这里应该显示aarch64表示是ARM64架构。这也是为什么我们要用ubuntu-ports源而不是普通的ubuntu源。最后检查下当前源的状态sudo apt update记下更新速度和各种报错信息等换源后再对比你会明显感受到差别。我第一次做这个对比测试时更新速度从原来的300KB/s直接飙升到10MB/s效果立竿见影。3. 详细换源步骤手把手教学现在进入正题教大家如何把官方源替换成USTC镜像源。整个过程分为备份、修改、更新三个步骤我会详细说明每个环节的注意事项。3.1 备份原有源列表安全第一修改前一定要先备份。这个习惯帮我躲过了无数次灾难。执行以下命令sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak这样就算改错了也能随时恢复。我建议再把这个备份文件拷贝到home目录下cp /etc/apt/sources.list.bak ~/双重保险更放心。有一次我不小心把sources.list清空了多亏有这个备份否则就得重装系统了。3.2 修改sources.list文件用nano编辑器打开源文件sudo nano /etc/apt/sources.list把文件内容全部删除替换为以下内容deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal main restricted universe multiverse deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-updates main restricted universe multiverse deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-backports main restricted universe multiverse deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-security main restricted universe multiverse注意几点每行开头的deb表示二进制包deb-src是源代码包一般开发用不到我就注释掉了[archarm64]明确指定了ARM64架构focal要和你系统的Codename一致USTC的镜像地址是https协议更安全修改完成后按CtrlO保存CtrlX退出。建议再用cat命令检查下文件内容cat /etc/apt/sources.list确保没有输错任何字符。我曾经因为少写了一个字母s把https变成http结果导致后续更新失败排查了好久才发现。3.3 更新软件包列表最后执行更新sudo apt update这个命令会从新的镜像源获取最新的软件包信息。正常情况下你应该能看到速度明显提升而且没有报错。如果出现Failed to fetch之类的错误可能是网络问题可以尝试检查网络连接确认镜像地址是否正确暂时关闭防火墙测试更新完成后可以升级已安装的软件包sudo apt upgrade这一步不是必须的但建议定期执行保持系统最新。我一般每周做一次完整更新确保安全补丁都能及时打上。4. 验证与常见问题排查换源完成后我们需要验证是否真的生效了。这里分享几个实用技巧和常见问题的解决方法。4.1 如何确认正在使用USTC源执行apt update时注意看输出的URL。你应该能看到mirrors.ustc.edu.cn的字样Get:1 https://mirrors.ustc.edu.cn/ubuntu-ports focal InRelease [265 kB] Get:2 https://mirrors.ustc.edu.cn/ubuntu-ports focal-updates InRelease [114 kB] ...更直观的方法是测速。安装speedtest-clisudo apt install speedtest-cli speedtest对比换源前后的下载速度。我在北京测试USTC源的下载速度能到50Mbps以上而官方源经常不到1Mbps。4.2 常见错误及解决方案问题1证书验证失败错误信息可能包含Certificate verification failed。这是因为有些老系统没有更新CA证书。解决方法sudo apt install ca-certificates sudo update-ca-certificates问题2404 Not Found如果看到404错误可能是版本代号写错了。比如把focal写成了bionic。仔细检查lsb_release -a的输出确保一致。问题3速度仍然很慢可能是DNS问题。尝试修改/etc/resolv.conf使用公共DNSnameserver 8.8.8.8 nameserver 114.114.114.114然后重启网络服务sudo systemctl restart systemd-networkd4.3 其他实用技巧如果你想换回官方源直接恢复之前的备份即可sudo cp /etc/apt/sources.list.bak /etc/apt/sources.list sudo apt update对于需要特定软件的情况可以单独添加PPA源。比如要安装最新版的GCCsudo add-apt-repository ppa:ubuntu-toolchain-r/test sudo apt update sudo apt install gcc-12定期清理旧的软件包节省空间sudo apt autoremove sudo apt clean我在Jetson Orin上开发时发现存储空间很宝贵。定期清理可以避免空间不足的问题。5. 进阶配置优化APT性能基础换源完成后还可以进一步优化APT的性能和使用体验。这些技巧都是我在实际项目中总结出来的能显著提升开发效率。5.1 配置APT缓存代理如果你有多台Jetson设备可以设置APT缓存代理避免重复下载。安装apt-cacher-ngsudo apt install apt-cacher-ng sudo systemctl enable apt-cacher-ng然后在其他设备的/etc/apt/apt.conf.d/02proxy文件中添加Acquire::http::Proxy http://代理服务器IP:3142;这样所有软件包只需要下载一次后续安装都会从本地缓存获取。我在实验室部署了10台Orin设备用这个方法节省了90%的带宽。5.2 选择性更新源有时候我们只需要安全更新可以注释掉其他源只保留security# deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-updates main restricted universe multiverse # deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-backports main restricted universe multiverse deb [archarm64] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-security main restricted universe multiverse这样apt update会更快适合对稳定性要求高的生产环境。5.3 使用apt-fast加速下载apt-fast是apt的并行下载工具能大幅提升大文件的下载速度。安装方法sudo add-apt-repository ppa:apt-fast/stable sudo apt update sudo apt install apt-fast使用时只需把apt换成apt-fastsudo apt-fast install tensorrt实测下载大型AI框架时速度能提升3-5倍。特别是在网络状况复杂的环境下效果更明显。6. 开发环境配置建议换源只是第一步要充分发挥Jetson Orin的性能还需要合理配置开发环境。这里分享一些我在AI项目中的经验。6.1 基础开发工具安装首先安装必备的开发工具sudo apt install build-essential cmake git python3-dev python3-pip对于AI开发建议安装以下软件包sudo apt install libopencv-dev libboost-all-dev libeigen3-dev这些是计算机视觉和深度学习的基础依赖库。我建议在系统初始化时就装好避免后续各种奇怪的编译错误。6.2 Python环境配置虽然系统自带Python3但建议使用虚拟环境pip3 install virtualenv virtualenv ~/venv -p python3 source ~/venv/bin/activate这样能避免污染系统Python环境。安装AI相关的Python包时建议使用USTC的PyPI镜像pip install -i https://pypi.mirrors.ustc.edu.cn/simple/ numpy torch torchvision大型框架下载速度能快10倍不止。我在安装PyTorch时官方源要1个多小时换源后5分钟就搞定了。6.3 深度学习框架选择Jetson Orin对TensorRT的支持最好建议优先考虑sudo apt install tensorrt python3-libnvinfer-dev对于PyTorch用户可以安装NVIDIA官方提供的预编译版本pip install --extra-index-url https://developer.download.nvidia.com/compute/redist/jp/v50 torch1.13.0 torchvision0.14.0注意要选择与JetPack版本兼容的框架版本。我曾经因为版本不匹配导致模型推理速度慢了50%排查了好久才发现是框架版本问题。