在 ASUSTOR NAS 配置 Git 仓库

课程目的

完成此课程后您将能够：

1. 使用 ASUSTOR NAS 创建 Git 仓库。

必修项目

课程必修项目：

無

学生须先具备以下知识：

Linux、Git

大纲

1. Git 简介

1.1 在 ASUSTOR NAS 安装 Git

2. 在 ASUSTOR NAS 创建 Git 仓库

2.1 创建 Git 共享文件夹

2.2 配置 Git 仓库

3. Git 用户端连接 NAS 上的 Git 仓库

1. Git 简介

Git 是一种免费开源的分散式版本的版本控制系统（Version Control Stystem）。记录一个或若干个文件的状态变化，并可以随时切换到某个「版本」时候的状态，以便查看特定版本修订情况的系统。可以清楚地纪录每个文件的拥有者、时间、修改异动。

分散式的版本控制系统在没有服务器或是没有网络的环境，依旧可以使用 Git 来进行版本控制，待服务器恢复正常运作或是有网络的环境后再进行同步，不会受影响。

1.1 在 ASUSTOR NAS 安装 Git

• 使用网页浏览器并以系统管理员群组的帐户登录 ADM。
• 在 ADM 画面上选择 [App Central]，输入 Git 进行搜寻。
• 点选 [Git] 后，点击 [安装]。
• Git 只支援使用命令列操作，因此安装完成后，不会出现 ADM 桌面图示标。

2. 在 ASUSTOR NAS 创建 Git 仓库

ASUSTOR 提供的 Git 仅适用于系统管理员群组的用户使用，在使用 Git 前，ASUSTOR 建议您建立新的共享文件夹来统一管理 Git 仓库的所有文件。

2.1 创建 Git 共享文件夹

• 点选 [访问控制] [共享文件夹]。
• 点击 [新增]。

• 在 NAS 上新增一个共享文件夹。
• 请先为文件夹命名然后点选 [下一步]。( 以下图为例，将新文件夹命名为 Git_Repository)

• 从选单中选取设置的文件夹访问权限 (以下图为例，选择 [管理员群组可读取及写入，其余用户仅能读取] )。
• 设置结束后请点选 [下一步]。

• 检查并确认设置后点选 [完成]。

2.2 配置 Git 仓库

Git 只支援使用命令列操作，请务必启用 SSH 服务。

• 点选 [服务] [终端机] [SSH]。
• 勾选 [启用 SSH 服务] 并点击 [套用]。

• 通过 SSH 工具登录 NAS，并进入前一章节建立的共用文件夹 [Git_Repository]。
• 输入下列命令来建立新的文件夹，通常以 Git 专案名称命名，以 TestProject 为例。亦可使用 ADM 文件总管在 Git_Repository 下建立新文件夹。
• $ mkdir TestProject

• 进入 TestProject 文件夹，输入下列命令初始化 Git 仓库。
• $ git init -- bare

• 初始化 Git 仓库完成，在 ADM 文件总管可以看 Git 仓库已配置完成。

3. Git 用户端连接 NAS 上的 Git 仓库

初始化 Git 仓库完成，在 ADM 文件总管可以看 Git 仓库已配置完成。 用户可于其他同样支持 Git 的用户端电脑安装合适的软件来克隆在 NAS 上的 Git 仓库，于不同的平台修改及 commit 原始码。

此范例以 Windows 10 为例，请参考Git 官网，下载安装 Windows 版本 Git。

• Git 安装完成后，开启 Windows 文件总管，创建新文件夹以管理 Git。此范例中创建 [Git_Clone] 文件夹。

• 于 [Git_Clone] 右侧空白处点击右键，选择 [Open Git Bash here]。

• 输入 git clone 命令连接 NAS 文件夹，以克隆该专案的原始码。
• $ git clone ssh://admin@{NAS_IP}/volume2/Git_Repository/TestProject
• 输入使用 ssh 登录 NAS 的帐户密码。
• Git 克隆完成后，即可在本地 Windows 端修改、编写及 Commit 原始码。

使用 Windows 版本 Git GUI 操作：

• 于 [Git_Clone] 右侧空白处点击右键，选择 [Open Git GUI here]。

• 点选 [Clone Existing Repository]。

• 输入来源端 NAS Git 文件夹及本地端文件夹。
• 点击 [Clone]，即可克隆该专案的原始码。

• 输入使用 ssh 登录 NAS 的帐户密码。

• Git 克隆完成后，即可在本地 Windows 端修改、编写及 Commit 原始码。

使用 Windows 版本 TortoiseGit 操作：

• 于 [Git_Clone] 右侧空白处点击右键，选择 [Git Clone…]。

• 输入 NAS Git 文件夹 URL 及本地端文件夹。
• 点击 [OK]，即可克隆该专案的原始码。

• 输入使用 ssh 登录 NAS 的帐户密码。

• Git 克隆完成后，即可在本地 Windows 端修改、编写及 Commit 原始码。