本頁面包含 Google Season of Docs 接受的技術寫作專案詳細資料。
專案摘要
- 開放原始碼機構：
- Whonix
- 技術撰稿人：
- 0brand
- 專案名稱：
- 記錄新版以安全性為主的強化 Debian Linux 發行版安裝和設定程序。
- 專案長度：
- 標準長度 (3 個月)
Project description
強化型 Debian 是 Whonix 開發人員積極開發的新 Linux 發行版，著重於安全性。這個專案從頭開始記錄在 Windows/VirtualBox 中安裝及設定 Hardened Debian 的過程，著重於教導 Linux 初學者使用 Linux 發行版時所需的技能。
專案目標
建立核心說明文件
這個專案的初期階段將著重於 Hardened Debian 的核心文件。內容包括完整的專案總覽、安裝及設定強化的 Debian 教學課程，以及安裝後建議和提示。
為 Linux 新手建立學習領域
教導 Linux 新手並非撰寫幾份說明文件，然後就稱之為教育領域。許多新手不習慣與命令提示字元互動，也不會自行排解問題。這些頁面將著重於 CLI 技能、實務問題解決和疑難排解最佳做法。
清楚區分 Hardened Debian 與 Whonix (匿名作業系統) 說明文件：
雖然 Whonix.org 同時提供 Whonix 和 Hardened Debian，但這兩種 OS 的用途截然不同，如果使用者混淆兩者，可能會導致嚴重後果。舉例來說，Whonix 以匿名性聞名，但如果新使用者不熟悉 Whonix，可能會設定 Hardened Debian，並以為自己正在匿名瀏覽網頁。為避免這類錯誤，Hardened Debian 說明文件將使用新的書籍格式樣式，與 Whonix OS 說明文件格式樣式有所區別，並限制在 Whonix.org 的獨立區域中。此外，我們也會在 Hardened Debian 下載頁面等重要區域加入警告，避免使用者犯下這些錯誤。
容易使用的說明文件
即使是經驗豐富的使用者，也可能覺得 Linux 發行版的安裝和設定程序相當困難。簡單好用且直覺的 UI 可提升使用者體驗，但撰寫清楚易懂的使用者友善文件也同樣重要。由於 Hardened Debian 的使用者涵蓋初學者到進階 Linux 使用者，因此撰寫文件時，必須注意不要只根據技術撰稿人的專業知識和理解撰寫。我們將從 Linux 初學者的角度記錄 Hardened Debian，這類使用者可能難以執行經驗豐富的使用者認為簡單且容易完成的工作。
鼓勵社群參與/貢獻
強化 Debian 是一項艱鉅的專案，只有確保社群在整個專案期間持續參與，才能完全完成。只有在社群成員的意見獲得熱烈迴響，且他們的絕佳想法用於改善文件時，他們才會繼續參與。在整個 GSoD 期間，我都會在 Whonix 論壇上保持活躍，鼓勵社群提供意見回饋和貢獻，以改善文件。
重新命名 Hardened Debain OS
雖然這個作業系統是以強化的 Debian 為基礎，但為避免違反商標侵權規定，我們必須為其命名新名稱。為達成這個目標，我們鼓勵 Whonix 社群提交朗朗上口的名字，供 Whonix 開發人員選擇。雖然還在腦力激盪階段，但我最喜歡的兩個名稱是「Sentient Linux」和「Sentinel Linux」。
專案時間軸
這個專案的時間表會分成 7 個迷你里程碑，可用於評估進度，並進行調整，確保每個部分都能如期完成。如果我在 Season of Docs 期間遇到任何困難，會立即通知指導老師，以便制定行動計畫來解決問題。
9 月 2 日 ( 開始 Season of Docs 專案)
首頁會提供 Hardened Debian 的總覽，詳細說明作業系統的重點。
初始文件將包含在 Windows/VirtualBox 中安裝 Hardened Debian 的內容。這會限制本章的初始範圍。不過，我們鼓勵社群成員在 Linux 主機和 KVM Hypervisor 中測試 Hardened Debian，並記錄發現的問題。
下表詳細列出支援的主機作業系統
詳細說明硬體需求的表格。
- 最低需求條件
- 推薦
- 如要獲得最佳效能
內容包括：詳細說明 Hardened Debian 開發目標和用途的總覽，以及列出個別元件的表格。
強化 Debian 目標。
- 以安全性為主的 Linux 發行版
- 免費且開放原始碼
- 使用者可設定
- 預設為強化
構成 Hardened Debian 的元件表格。
- VirtualBox 管理程序
- Windows
- 以 Debian 為基礎的強化作業系統
- 術語 (主機、虛擬機器、客體 OS 等)
預設情況下，強化型 Debian 會設定許多進階安全功能。這樣使用者就不必費力處理複雜的設定。所有安全性強化措施都會列在表格中，並簡要說明優點。
- 預設安裝 Haveged，以提升熵值。
- 系統會使用 Secure Distributed Network Time Synchronization (sdwdate)，而非保險 NTP。
- 停用 Dolphin 和 Nautilus 的預覽功能。
- 停用 TCP 時間戳記和 Netfilter 的連線追蹤輔助程式。
- open-link-confirmation.
- 預設啟用 Apparmor，並提供設定檔。
- 強化安全性的瀏覽器 (不含 Tor 的 Tor 瀏覽器)
改良的 Linux 核心
桌面環境；KDE (僅適用於 CLI)。
其他 ...
里程碑 9 月 15 日 (完成系統需求、功能和優勢、設計和目標)
常見問題頁面將用於回答社群成員經常提出的問題。專案進行期間，系統會視需要新增內容。
下載及安裝 Hardened Debian 的步驟如下。
- 下載表格，內含 Hardened Debian 映像檔、OpenGPG 簽章、sha512 雜湊和開發人員 GPG 簽署金鑰。
- 驗證開發人員簽署金鑰和作業系統映像檔 (教學課程)。
- 下載並驗證 VirtualBox 管理程序 (教學課程)。
- 在 VirtualBox 中匯入 Hardened Debian (教學課程)
- 啟動強化版 Debian
里程碑：9 月 29 日 (完成下載及驗證 Debian 映像檔、Debian 安裝)
使用者可能不熟悉自訂桌面環境和分配系統資源的步驟。以下各項都會提供「快速設定」提示。
- 變更鍵盤配置
- 配置額外系統資源 (RAM)
- 變更螢幕解析度
- 桌面捷徑
- 視窗樣式管理工具
測試作業系統和教學課程時發現的錯誤和問題，都會清楚記錄下來，並附上解決方法和/或修正方式。本頁也會列出在 Hypervisor 中執行作業系統時的常見問題。
- RAM 不足問題
- BIOS 設定錯誤 (Intel VT-d、AMD-V)
- 連線問題
里程碑：10 月 6 日 (完成第一步、修正 Debian 錯誤)
新使用者可能不熟悉 Linux 終端機/CLI。如果使用者無法輕鬆找到或存取所需資訊，他們甚至不會嘗試尋找解決方案，就會直接提出支援要求。本節將說明常用指令和實用指令語法。每項 man 都會簡要說明指令、使用方式和實用範例。使用者需要一段時間才能記住不同工作要使用的指令。透過重複操作，使用者會逐漸記住指令語法。
- 終端機/CLI
- sudo
- 文字編輯器
- 目錄結構
- 檔案系統導覽
- 檔案權限
- 說明頁面
- 建立檔案/目錄
- 其他 (ls、cat、less)
里程碑：10 月 22 日 (完成學習區、說明頁面)
有能力/經驗豐富的 Linux 使用者具備良好的問題解決能力，這是他們長期累積的成果。遇到問題時，他們會自動開始尋找解決方案，直到找到答案或用盡所有可能的資源為止。新的 Linux 使用者遇到問題時，系統會自動開啟支援要求。因此務必從一開始就強化良好做法。
問題解決範本：使用者按照逐步說明排解問題時，成功率會更高。本節將著重於如何收集相關資訊，以及如何運用這些資訊找出問題的解決方案。這兩者類似。
監控記錄檔：系統記錄的位置 (各項記錄的用途) 和縮減 CLI 輸出內容範圍所需的指令。(journalctl、dmesg 等)
systemd：狀態、啟動和停止服務。
排解常見問題：連線問題、軟體套件損毀等。
錯誤和/或問題回報指南。
里程碑：11 月 5 日 (完成學習領域、解決問題)
在 Summer of Docs 的其餘時間，我們將著重於重構 Hardened Debian 的 Whonix 文件，以及品質控管。
重構 Whonix 文件，以便搭配使用 Hardened Debian
- 安全地安裝軟體。
- 作業系統更新