Skip to content

INSTALL.md

Latest commit

 

History

History
102 lines (73 loc) · 3.97 KB

INSTALL.md

File metadata and controls

102 lines (73 loc) · 3.97 KB

Linux 安装指南

本文档描述 Linux 平台的完整安装流水线。按步骤顺序执行即可完成基础环境搭建。

此文档需与目录下的脚本保持同步。

0. 拉取仓库

  • 脚本: 00quickstart.sh
  • 执行方式: bash linux/00quickstart.sh
  • 前置条件: 网络连接、git（脚本会自动安装 gh）
  • 可跳过: 是（如仓库已存在）
  • 说明: 安装 GitHub CLI，登录后 clone 仓库到 ~/projects/env/powershellScripts

如果不使用 gh，也可以手动 clone：

mkdir -p ~/projects/env && cd ~/projects/env
git clone https://github.com/mudssky/powershellScripts.git
cd powershellScripts/linux

1. 安装 Homebrew

  • 脚本: 01installHomeBrew.sh
  • 执行方式: bash linux/01installHomeBrew.sh
  • 前置条件: 网络连接、curl、git
  • 可跳过: 是（如已安装 Homebrew）
  • 说明: 安装 Homebrew 并配置环境变量。优先使用官方源，网络不通时自动切换清华源

2. 安装 PowerShell

  • 脚本: 02installPowerShell.sh
  • 执行方式: bash linux/02installPowerShell.sh
  • 前置条件: 步骤 1 完成（需要 dpkg/apt 或 Homebrew）
  • 可跳过: 是（如已安装 PowerShell）
  • 说明: 优先使用本地 deb 文件安装，失败则回退到 installer 脚本

3. 部署 Shell 配置

  • 脚本: 03deployShellConfig.sh
  • 执行方式: bash linux/03deployShellConfig.sh
  • 前置条件: 仓库已 clone（需要 shell/deploy.sh）
  • 可跳过: 是
  • 说明: 调用 shell/deploy.sh 部署 shell 配置片段到 ~/.bashrc.d/

4. 安装应用程序

  • 脚本: 04installApps.ps1
  • 执行方式: pwsh linux/04installApps.ps1
  • 前置条件: 步骤 2 完成（需要 PowerShell）
  • 可跳过: 是
  • 说明: 通过 Homebrew 安装开发工具，安装 bun、Docker 等

5. 管理 FNOS 外接数据盘挂载

  • 脚本: linux/fnos/fnos-mount-manager/build.sh
  • 执行方式: bash linux/fnos/fnos-mount-manager/build.sh
  • 前置条件: 仓库已 clone
  • 可跳过: 否（仅在需要管理 FNOS 外接盘时）
  • 说明: 构建 bin/fnos-mount-manager 与 linux/fnos/fnos-mount-manager/fnos-mount-manager.sh 两个单文件入口

推荐工作流：

# 1. 复制示例配置
cp linux/fnos/fnos-mount-manager/disks.example.conf linux/fnos/fnos-mount-manager/disks.local.conf

# 2. 按当前机器修改 LABEL/UUID
$EDITOR linux/fnos/fnos-mount-manager/disks.local.conf

# 3. 构建脚本
bash linux/fnos/fnos-mount-manager/build.sh

# 4. 生成挂载区块预览
bash linux/fnos/fnos-mount-manager/fnos-mount-manager.sh generate

# 5. 检查漂移和已知冲突
bash linux/fnos/fnos-mount-manager/fnos-mount-manager.sh check

# 6. 应用到系统
bash linux/fnos/fnos-mount-manager/fnos-mount-manager.sh apply

# 7. 重启后若 FNOS 把磁盘挂到型号路径或漏挂，执行统一协调
bash linux/fnos/fnos-mount-manager/fnos-mount-manager.sh reconcile

# 8. 注册开机自动协调 service
sudo bash linux/fnos/fnos-mount-manager/fnos-mount-manager.sh install-reconcile-service

补充说明：

  • install-reconcile-service 会把 reconcile 注册成开机 oneshot service；如需安装后立刻跑一次，可加 --start-now。
  • reconcile 是推荐的重启后入口，会先给已挂错路径的磁盘补业务名 alias，再补挂真正未挂上的磁盘。
  • repair 仍保留为保守修复工具，remount 仅用于你明确要接管底层真实挂载路径的场景。
  • tmpfiles 规则继续保留，不要移除；它只负责创建挂载点目录，不会替代 reconcile。
  • 需要移除的是旧的 force-remount-disks.service 或 shell 登录时的 mount -a 遗留逻辑，新 service 会尽量自动停用前者。
  • 当业务名路径验证稳定后，Samba 共享路径应优先指向业务名路径，而不是 FNOS 自动生成的型号路径。

PowerShell 已就绪，继续执行跨平台安装：docs/INSTALL.md