编码代理与终端

域内工具

域内问题条目

• apt-get update 报 404 Not Found / 源失效（Err:1 ... 404）
• ChatGPT Windows 客户端打不开：Unable to locate the Codex CLI binary / 找不到 Codex CLI
• Codex 桌面应用更新失败（应用内更新报错 / MSIX 手动安装）
• bash 脚本报 $'\r': command not found / bad interpreter: /bin/bash^M——Windows 换行符（CRLF）混入
• crontab 任务报 command not found / 环境变量缺失（nvm、conda 装的东西跑不了）
• 大文件下载中断后无法续传（curl: (33) HTTP server does not seem to support byte ranges）
• Docker build 缓存不生效（每次改代码都重跑安装层）—— COPY 顺序与 .dockerignore
• docker-compose / docker compose 报 command not found（Compose 没装或没接线）
• docker compose 起栈失败——依赖服务没就绪（Connection refused / unhealthy / depends_on 不生效）
• Docker 容器内域名解析失败（wget: bad address / Temporary failure in name resolution / Could not resolve host）
• docker 报 Conflict. The container name "/xxx" is already in use（容器名被占用）
• 容器进程突然被杀（OOMKilled / exit code 137）——内存限制与排查
• 容器里时间差 8 小时（date 显示 UTC）/ 中文乱码（UnicodeEncodeError）
• docker 命令报 Cannot connect to the Docker daemon at unix:///var/run/docker.sock / failed to connect to the docker API（连不上 daemon）
• Docker Desktop 启动失败：The file cannot be accessed by the system / 孤儿 AF_UNIX socket
• docker exec 报 the input device is not a TTY / container is not running / executable file not found
• Docker 容器内连不上宿主机服务（localhost 是容器自己，不是宿主机）
• docker pull 报 ERROR: Get "https://registry-1.docker.io/v2/" ... connection reset by peer / 拉取镜像失败
• docker 报 invalid reference format / repository name must be lowercase（镜像引用格式非法）
• docker pull 报 manifest for "xxx:latest" not found（镜像或标签不存在）
• docker run / compose up 报 port is already allocated / address already in use（端口被占用）
• docker system prune 到底删什么？容器/镜像/卷/缓存清理边界速查
• Docker bind mount / volume 权限报错（Permission denied）：容器进程无法读写挂载目录
• powershell 运行 .ps1 报「禁止运行脚本」——执行策略（ExecutionPolicy）限制
• 程序偶发 SIGSEGV 崩溃，gdb 显示 best=DBL_MAX 且指针为空——浮点比较"恒不成立"时哨兵从未被覆盖
• git 换行符混乱——diff 全部文件显示修改 / warning: LF will be replaced by CRLF / CRLF will be replaced by LF
• git 报 fatal: detected dubious ownership in repository at（仓库属主与当前用户不一致）
• git clone 公开仓库报 fatal: Could not read from remote repository / Please make sure you have the correct access rights and the repository exists（网络正常）
• GitHub 直连慢/失败（clone 被重置、443 连不上、SSH 认证、Release 下载中断）
• go get/go mod download 超时（dial tcp ... i/o timeout）→ 换 GOPROXY 国内代理
• `herdr server start` 无效 / 后台 server 未拉起（v0.8.2 没有 server start 子命令）
• Windows 上 herdr 用 PowerShell 安装失败（下载被重置；改直下二进制）
• SSH 远程用 herdr 中文显示乱码/输入无效（终端编码与 locale）
• Hugging Face 模型下载卡住/超时（国内）——HF_ENDPOINT 切 hf-mirror，代码零改动
• Java OOM 六种报错签名速查：heap space / Metaspace / StackOverflowError / native thread / GC Overhead
• Netty 直接内存 OOM：OutOfDirectMemoryError / Direct buffer memory（ByteBuf 泄漏 + MaxDirectMemorySize 未设）
• Node 构建/打包报 FATAL ERROR ... JavaScript heap out of memory（内存溢出）
• npm run 报 Error: error:0308010C:digital envelope routines::unsupported（Node 新版本 + 老 webpack）
• npm install 报 npm ERR! code ERESOLVE / ERESOLVE unable to resolve dependency tree（peer 依赖冲突）
• npm install -g 报 npm ERR! code EACCES permission denied（全局安装权限）
• npm install 慢/随机挂起/网络错误（ETIMEDOUT / ECONNRESET / hang forever）
• 安装成功但 omp --version 报 SyntaxError（旧版 bun）
• 命令混淆：omp install 与 omp plugin install
• Windows/ARM release 二进制加载外部扩展失败
• 名称混淆：oh-my-pi（omp）vs pi-mono（pi）
• Ubuntu/Debian pip install 报 error: externally-managed-environment（PEP 668）
• pip 安装超时/下载慢（ReadTimeoutError / WARNING: Retrying ... Read timed out）
• pip install 报 SSL 证书错误（CERTIFICATE_VERIFY_FAILED）——信任链断了，别急着 --trusted-host
• 设置了代理环境变量却不生效——有的命令走代理有的不走（HTTP_PROXY 大小写坑）
• python: command not found——Ubuntu 只有 python3，没有 python 命令
• Python 3.12+ 报 ModuleNotFoundError: No module named 'distutils'
• Python 读文件报 UnicodeDecodeError（utf-8/gbk codec can't decode byte）——文件编码与默认编码不匹配
• venv 移动/复制目录后失效（bad interpreter: No such file or directory / venv/bin/activate: No such file or directory）
• bash: ./script.sh: Permission denied——脚本缺执行权限
• 只有个别网站打不开（其他网站都正常）——从 curl 超时到分层定位
• SSH 报 UNPROTECTED PRIVATE KEY FILE / Permissions ... are too open（私钥权限过宽）
• 解压 tar 包多出顶层目录 / 文件散落一地 —— --strip-components 用法（macOS 报 Option not supported）
• 卸载后残留——共享配置不还原 / 命令仍在
• wsl --import 迁移/重装后默认用户变成 root，whoami 变了、权限全乱
• WSL 里报 Temporary failure in name resolution / 连不上网，VPN 一连上 WSL 就断网
• WSL 里运行 notepad.exe / cmd.exe 报 command not found（interop 失效）
• WSL 里报 No space left on device，但 df 显示还有大量空间
• PowerShell 里调 wsl 输出乱码（每字符带空字节 / 每字符一行 / 中文变 �）
• WSL 启动发行版报 WslRegisterDistribution failed（0x800701bc / 0x80370102）
• WSL 里 systemctl 报 System has not been booted with systemd / 服务起不来
• zip 解压后中文文件名乱码（Windows/360 压缩的文件在 Linux 上乱码）