CodeAlan's Blog

记录 UAV / 具身智能 / VLN 的学习与实践。

搜索

运维备忘 & 坑点记录

一页记：常用命令速查

Docker

  • 查看容器 / 镜像
docker ps          # 正在运行的容器
docker ps -a       # 包含已退出的容器
docker images      # 本地镜像
docker system df   # Docker 占用空间
  • 容器生命周期
docker run -it --rm IMAGE bash     # 交互式临时容器
docker stop NAME && docker rm NAME # 停止并删除容器
docker logs -f NAME                # 持续查看日志
  • Copyparty 文件站
./start_copyparty.sh
docker ps --filter name=copyparty-file
docker logs -f copyparty-file
docker compose --env-file copyparty/.env -f docker-compose.copyparty.yml down
  • 清理无用资源（谨慎使用）
docker system prune -f             # 删除无用容器/网络/构建缓存
docker image prune -a              # 删除所有悬挂/未使用镜像

tmux

  • 会话管理
tmux new -s vln        # 创建新会话
tmux ls                # 列出会话
tmux attach -t vln     # 连接会话
tmux kill-session -t vln
  • 常用快捷键（前缀默认 Ctrl+b）
    • Ctrl+b c：新建窗口
    • Ctrl+b n / p：切换下一/上一窗口
    • Ctrl+b "：水平分屏
    • Ctrl+b %：垂直分屏
    • Ctrl+b d：脱离会话（留在后台运行）

Git

  • 日常提交
git status
git add path/to/file
git commit -m "message"
git push origin master
  • 回退相关
git log --oneline --graph --decorate
git diff HEAD~1 HEAD      # 查看上一版差异
git restore path/to/file  # 撤销工作区修改

大文件与构建产物已通过 .gitignore 忽略：public/、static/files/、所有 *.pdf 等。

Nginx

  • 配置检查与重载
sudo nginx -t                 # 检查配置语法
sudo systemctl reload nginx   # 平滑重载
sudo systemctl restart nginx  # 重启
journalctl -u nginx -e        # 查看 Nginx 日志

acme.sh（证书）

  • 常用操作（以 codealan.top 为例）
~/.acme.sh/acme.sh --list
~/.acme.sh/acme.sh --issue \
  -d codealan.top -d www.codealan.top \
  -w /var/www/letsencrypt
~/.acme.sh/acme.sh --renew -d codealan.top --force

Bug & Pitfall 记事本

记录经常踩坑的地方，方便以后排查与帮别人解坑。

Hugo / 静态资源

  • 问题： 提交了 public/ 或大体积 PDF，GitHub 提示大文件警告。
  • 现状：
    • .gitignore 忽略 public/、static/files/、以及所有 *.pdf（static/**、content/**、public/**）。
    • 历史已经重建，当前仓库只包含源码与内容。
  • 经验：
    • 在服务器本地构建站点：
./build.sh
  • 不要把 public/ 和 PDF 等大文件提交到 Git。

Nginx / stream 分流

  • 问题： 443 端口既要给博客用，又要给 VLESS-Reality 使用。
  • 解决：
    • 使用 stream + ssl_preread 按 SNI 分流：aws.amazon.com → sui，codealan.top / www.codealan.top → 博客。
    • 注意 nginx.conf 需要包含 stream 配置，例如：
include /etc/nginx/stream.conf;
  • file.codealan.top 反代 Copyparty 上传大文件时，在对应 server 或 location / 中加入：
client_max_body_size 0;
proxy_request_buffering off;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
  • Copyparty 登录失败并提示 rejected by cors-check 时，先看容器日志；若出现 x-forwarded-for from untrusted source 172.x.x.x，需要在 Copyparty 启动参数里信任 Docker 网桥/私网来源，例如 --xff-src lan，否则它会忽略 X-Forwarded-Proto 并把 HTTPS 登录误判成 HTTP 请求。
  • Copyparty 的 --u2sz 只接受整数 MiB，无法稳定降到 Nginx 默认 1MiB 以下；上传大文件触发 413 Request Entity Too Large 时，应修复 Nginx 的 client_max_body_size。
  • Copyparty 上传速度慢时，可在启动参数中使用 --turbo 2 --u2j 6 --u2sz 8,16,64：默认开启 turbo，提高浏览器并发上传任务，并减少小分片请求开销。

Docker / GPU 环境

  • 问题示例： 容器里看不到 GPU / 驱动版本不匹配。
  • 排查点：
    • 宿主机是否安装正确的 NVIDIA 驱动 + nvidia-container-toolkit。
    • 检查宿主机与容器中的 GPU 可见性：
# 宿主机检查
nvidia-smi

# 容器中检查（示例）
docker run --rm --gpus all nvidia/cuda:12.2.0-base nvidia-smi

终端与 tmux

  • 问题： tmux 中中文 / Powerline 字体错位。
  • 经验：
    • 终端统一使用 Nerd Font / 等宽字体。
    • 确认 $LANG 与 locale 设置一致（如 zh_CN.UTF-8）：
echo $LANG
locale

之后遇到新的环境坑、兼容性问题，可以按模块继续往这个页面追加小节即可。