系统问题¶
Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.
系统是否有默认的用户和密码？¶
没有。Debian系统首次启动时需要创建用户账号，请牢记您设置的用户名和密码，后续登录将使用该凭据。
如何解决中文输入法不支持的问题？¶
可按照以下步骤安装并配置中文输入法：
# 1.安装
sudo apt install ibus ibus-libpinyin fonts-noto-cjk -y
# 2.查询
gsettings get org.gnome.desktop.input-sources sources
# 3.配置
gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'libpinyin')]"
# 4.重启
reboot
# 5.切换输入法，Super即Windows徽标键
Super + Space
如何查看当前系统状态？¶
# 查看CPU运行状态（动态）
top
# 查看当前正在运行和等待的进程
ps aux | grep <comm>
# 查看内存、交换分区的整体使用情况
free -h
# 查看磁盘分区使用率
df -h
如何查看系统版本？¶
# 查看编译版本
cat /etc/quectel-release
# 查看内核版本
uname -a
如何进行系统升级？¶
sudo apt update
sudo apt upgrade
软件包无法下载怎么办？¶
检查网络连接与代理¶
网络连通性：首先确保设备已联网，可以执行 ping -c 4 8.8.8.8 或 ping -c 4 archive.ubuntu.com测试。如果ping不通，需要检查网线、Wi-Fi或IP地址配置。
代理服务器：若使用代理，需确认其配置正确，或者尝试暂时关闭代理。可以检查并临时重命名 /etc/apt/apt.conf.d/ 下的代理配置文件（如 proxy.conf）。
检查并更换软件源¶
软件源配置错误是导致无法下载的常见原因。
查看当前源：执行 cat /etc/apt/sources.list 和 ls -l /etc/apt/sources.list.d/，检查其中是否存在无效或过时的地址。
更换镜像源：若默认源不稳定或速度较慢，可更换为国内镜像源（如清华、阿里云、中科大），以提升下载速度和成功率。更换后，需要执行 sudo apt update 使其生效。详情请参考 软件更新。
备份源文件：修改前请先执行 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak 进行备份。
更新软件包列表与修复依赖¶
过期的软件包列表或损坏的依赖关系会导致下载失败。
更新包列表：此为关键步骤，执行 sudo apt update，确保系统可获取最新软件包。
修复依赖关系：若更新后仍有问题，可尝试执行 sudo apt --fix-broken install 修复损坏的依赖。
使用 –fix-missing 选项：若遇到 Unable to fetch some archives 错误，可尝试执行 sudo apt update --fix-missing。
检查磁盘空间与进程占用¶
磁盘空间不足或包管理器被占用也会导致下载失败。
检查磁盘空间：执行 df -h 查看根分区（/）和 /var 分区的空间是否充足。若空间不足，可执行 sudo apt clean 清理APT缓存，并执行 sudo apt autoremove 卸载无用软件包。
检查进程占用：若有其他APT或dpkg进程运行，可执行 ps aux | grep -E “apt|dpkg” 查看。等待其完成，或执行 sudo kill -9 <进程ID> 强制终止。如果无法终止，可执行 sudo rm /var/lib/apt/lists/lock 尝试删除锁文件。
排查其他因素¶
确认包名：包名拼写错误也会导致定位失败，可执行 apt-cache search <关键词> 查找正确的包名。
导入GPG密钥：若更新时提示GPG错误，可能是缺少密钥，可执行 sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys <缺失的密钥ID> 进行导入。
检查系统时间：系统时间不正确会导致HTTPS证书验证失败，可执行 date 命令检查。若时间有误，可执行 sudo timedatectl set-ntp true 同步。
若镜像源中未包含相关软件包，可下载.deb包后，执行 sudo dpkg -i xxx.deb 完成本地安装。
内存占用过高如何排查？¶
确认是否确系内存不足¶
free -h
cat /proc/meminfo | head -30
重点关注以下字段：
MemAvailable
SwapFree
Cached
Buffers
Slab
SReclaimable
SUnreclaim
判断原则：
used 值偏高未必存在问题，Linux系统会将空闲内存用作页面缓存。
关键在于检查 MemAvailable 是否过低。
仅当 MemAvailable 过低、swap使用量持续增加且系统出现卡顿时，方可判定为真实的内存压力。
检查是否发生OOM或内存告警¶
dmesg -T | grep -i -E "oom|out of memory|killed process|memory allocation failure"
journalctl -k | grep -i -E "oom|out of memory|killed process"
若出现以下日志信息，则表明系统已发生内存耗尽（OOM）问题。
Out of memory
Killed process xxx
查找占用内存最高的进程¶
ps aux --sort=-rss | head -20
或：
ps -eo pid,ppid,comm,rss,vsz,%mem --sort=-rss | head -30
字段含义：
字段 |
含义 |
|---|---|
RSS |
实际占用物理内存 |
VSZ |
虚拟地址空间，不等于真实占用 |
%MEM |
占总内存比例 |
也可以使用：
top
进入界面后，按 M 键，再根据内存使用率排序。
M
查看某个进程的详细内存¶
假设进程PID为 1234：
cat /proc/1234/status | grep -E "VmRSS|VmSize|VmData|VmSwap|Threads"
更详细的信息：
cat /proc/1234/smaps_rollup
重点关注以下字段：
Rss
Pss
Private_Clean
Private_Dirty
Swap
若 Private_Dirty 持续增长，通常表明存在内存泄漏。
系统死机怎么办？¶
评估系统死机程度：检查键盘、网络或串口是否仍有响应。
有响应（软死机）：例如SSH仍可连接、串口仍可接收输入，或SysRq键仍有效。这表明内核仍在运行，仅个别进程处于卡死状态。建议优先尝试诊断问题，以避免强制重启导致故障现场丢失。
完全无响应（硬死机）：键盘指示灯不闪烁、网络连接完全中断、串口无任何输出。此情况通常由内核崩溃（Kernel Panic）、硬件锁死或致命中断风暴引起。此时仅能通过硬件复位或断电进行恢复。