nltdeploy

一组面向本机开发与服务管理的 Bash 脚本。

覆盖这些场景：

• 开发环境：pip 镜像、uv、Python 虚拟环境、Go、Rust、Node.js、pnpm
• 常驻服务：Airflow、Celery、Paperclip、code-server、new-api、sub2api
• 常用工具：gum、GitHub 下载加速、GitHub 网络诊断、按端口杀进程

脚本尽量自包含，可在仓库内直接执行，也可 curl | bash。推荐先安装到本地 ~/.local/nltdeploy，之后统一用 nlt-* 命令。

安装

chmod +x install.sh
./install.sh
./install.sh install
./install.sh update
./install.sh uninstall

curl -LsSf https://raw.githubusercontent.com/farfarfun/nltdeploy/HEAD/install.sh | bash -s -- install
curl -LsSf https://gitee.com/farfarfun/nltdeploy/raw/master/install.sh | bash -s -- install

如未自动生效，手动加入 PATH：

export PATH="$HOME/.local/nltdeploy/bin:$PATH"

常用安装变量：

• NLTDEPLOY_ROOT：安装根目录
• NLTDEPLOY_SKIP_GIT_PULL=1：跳过安装前 git pull
• NLTDEPLOY_SKIP_PROFILE_HINT=1：不写 shell 配置，适合 CI
• NLTDEPLOY_UNINSTALL_YES=1：非交互卸载确认

主要模块

开发环境

• nlt-dev：开发环境统一入口
• nlt-pip-sources：pip 镜像配置
• nlt-python-env：Python/uv 环境

服务

• nlt-airflow
• nlt-celery
• nlt-paperclip
• nlt-code-server
• nlt-new-api
• nlt-sub2api
• nlt-services

工具

• nlt-utils
• nlt-github-net
• nlt-download
• nlt-cockpit-tools
• nlt-port-kill

目录结构

scripts/
  dev/        开发工具统一入口
  tools/      非常驻工具与环境脚本
  services/   常驻服务脚本与 nlt-services 聚合入口
  lib/        公共 Bash 库
tests/        冒烟测试
install.sh    安装 nlt-* 包装命令

说明

• 环境：macOS / Linux，Bash 3.2+，通常需要 curl
• 模块依赖与环境变量：以各自 setup.sh 文件头注释为准
• 冒烟测试：

bash tests/install_smoke.sh
bash tests/progress_smoke.sh

• 没执行权限：chmod +x install.sh 或对应 setup.sh
• PATH 未生效：手动 export PATH="$HOME/.local/nltdeploy/bin:$PATH"
• GitHub 下载慢或失败：优先看 nlt-github-net、nlt-download

详细文档

• install.sh
• scripts/dev/README.md
• scripts/tools/pip-sources/README.md
• scripts/tools/python-env/README.md
• pyproject.toml

许可证

MIT License