UYUNI 2022.12 Server或Proxy客戶端配置使用指南

烏尤尼 2022.12
快速入門指南
19 年 2022 月 XNUMX 日

快速入門
更新：2022-12-19
本指南向您展示如何安裝和設定單一 Uyuni 伺服器或代理程式。
它包含有關選擇簡單設置、工作流程和一些常見用例的說明。
您可以閱讀以下快速入門指南：

安裝Uyuni伺服器
安裝 Uyuni 代理

內容隱藏

1 第 1 章使用 openSUSE Leap 安裝 Uyuni 服務器

2 第 2 章使用 openSUSE Leap 安裝 Uyuni 代理

第 1 章使用 openSUSE Leap 安裝 Uyuni 服務器

Uyuni Server 可以安裝在 openSUSE Leap 上。

有關 Uyuni 穩定版本的信息，請參閱 https://www.uyuni-project.org/pages/stableversion.html.
有關 Uyuni 開發版本的信息，請參見 https://www.uyuni-project.org/pages/devel-version.html.

有關 openSUSE Leap 的最新版本和更新的信息，請參閱 https://doc.opensuse.org/release-notes/.

1.1.軟體和硬體需求
下表顯示了在 openSUSE Leap 上安裝 Uyuni 伺服器的軟體和硬體需求。

表 1. 軟件和硬件要求

軟硬體	受到推崇的
作業系統:	openSUSE Leap 15.4：全新安裝，最新
中央處理器：	至少 4 個專用 64 位 x86-64CPU 內核
記憶體：	測試伺服器至少 8 GB
	基本安裝至少 16 GB
	生產服務器最低 32 GB
磁碟空間：	磁盤空間取決於您的頻道要求，至少 100 GB
	每個 SUSE 或 openSUSE 產品 50 GB，每個 Red Hat 產品 360 GB
交換空間：	3GB

1.2.在 openSUSE Leap 上安裝 Uyuni 伺服器
您可以使用運行 openSUSE Leap 的物理機或虛擬機來安裝 Uyuni 服務器。在開始之前在服務器上配置一個可解析的完全限定域名，以確保可以通過網絡訪問服務器。
Uyuni Server 軟件可從 download.opensuse.org 獲得，您可以使用 zypper 檢索該軟件並進行安裝。
過程：使用 Uyuni 安裝 openSUSE Leap

安裝 openSUSE Leap 作為基礎系統，並確保已應用所有可用的服務包和包更新。

通過導航到系統 › 網絡設置 › 主機名/DNS，使用 YaST 配置可解析的完全限定域名 (FQDN)。
在命令提示字元處，以root 身分新增用於安裝Uyuni 伺服器軟體的儲存庫： repo=repositories/systemsmanagement:/ repo=${repo}Uyuni:/Stable/images/repo/Uyuni-Server-POOL-x86_64- Media1/齊珀爾 https://download.opensuse.org/$repouyuni-server-stable

從存儲庫刷新元數據：
zypper 參考
為 Uyuni 服務器安裝模式：
模式中的 zypper-uyuni_server
重新啟動伺服器。

安裝完成後，您可以繼續進行 Uyuni 設定。有關更多信息，請參閱安裝和升級 › Uyuni-server-setup。

1.3.使用 YaST 設定 Uyuni 伺服器
初始設置過程由 YaST 處理。

程序：Uyuni 設置

登錄到 Uyuni 服務器並啟動 YaST。
在 YaST 中，導航至網絡服務 › Uyuni 設置以開始設置。

從介紹畫面中選擇 Uyuni 設定 › 從頭開始設定 Uyuni，然後按一下 [下一步] 繼續。
輸入電子郵件地址以接收狀態通知，然後按一下[下一步]繼續。 Uyuni 有時會發送大量通知電子郵件。您可以在以下位置停用電子郵件通知 Web 設置後的 UI（如果需要）。

輸入您的證書資訊和密碼。密碼長度必須至少為七個字符，且不得包含空格、單引號或雙引號（' 或“）、感嘆號（!）或美元符號（$）。始終將您的密碼儲存在安全的位置。
如果您還需要設置 Uyuni 代理服務器，請確保您已記下證書密碼。
按一下[下一步]繼續。
在 Uyuni 設定 › 資料庫設定畫面中，輸入資料庫使用者和密碼，然後按 [下一步] 繼續。密碼長度必須至少為七個字符，且不得包含空格、單引號或雙引號（' 或“）、感嘆號（!）或美元符號（$）。始終將您的密碼儲存在安全的位置。

按一下[下一步]繼續。
出現提示時點選 [是] 執行安裝程式。
設定完成後，按一下[下一步]繼續。您將看到烏尤尼的地址 Web UI。
點選【完成】完成Uyuni設定。

1.4.建立主管理帳戶
在您可以登錄到服務器來管理您的客戶端之前，您需要創建一個管理帳戶。主管理賬戶在烏尤尼擁有最高權限。確保您保護此帳戶的訪問信息安全。我們建議您為組織和組創建較低級別的管理帳戶。不要共享主要的管理訪問詳細信息。

過程：設置主管理帳戶

在你的 web 瀏覽器，輸入Uyuni的地址 Web 用戶界面。此地址是在您完成設置後提供的。
登入 Web UI，導航到創建組織 › 組織名稱字段，然後輸入您的組織名稱。

在 Create Organization › Desired Login 和 Create Organization › Desired Password 字段中，輸入您的用戶名和密碼。
填寫帳戶信息字段，包括用於系統通知的電子郵件。

點選【建立組織】完成管理帳戶的建立。

當您完成烏尤尼 Web UI 設定，您將進入首頁 › 結束view 頁。

1.5.可選：從 SUSE 客戶中心同步產品
SUSE Customer Center (SCC) 維護著一個存儲庫集合，其中包含適用於所有受支持的企業客戶端系統的軟件包、軟件和更新。這些存儲庫被組織成通道，每個通道都提供特定於分發、發布和架構的軟件。與 SCC 同步後，客戶端可以接收更新、分組並分配到特定的產品軟件頻道。

本節介紹從 SCC 同步 Web UI 並添加您的第一個客戶渠道。
對於 Uyuni，從 SUSE Customer Center 同步產品是可選的。
在您可以與 SCC 同步軟件存儲庫之前，您需要輸入組織

烏尤尼的憑證。組織憑據使您可以訪問 SUSE 產品下載。您將在中找到您的組織憑據 https://scc.suse.com/organizations.
在 Uyuni 中輸入您的組織憑據 Web 使用者介面:

可選過程：輸入組織憑據

1烏尤尼 Web UI，導航到管理 › 設置嚮導。
在設定精靈頁面中，導覽至[組織憑證]標籤。

按一下[新增憑證]。
輸入使用者名稱和密碼，然後按一下[儲存]。

確認憑據後會顯示一個複選標記圖標。成功輸入新憑據後，即可與 SUSE Customer Center 同步。

可選過程：與 SUSE Customer Center 同步

在烏尤尼 Web UI，導航到管理 › 設置嚮導。

從安裝精靈頁面中選擇 [SUSE Products] 標籤。稍等片刻，讓產品清單填充完畢。如果您之前在 SUSE 客戶中心註冊，則產品清單將填入表格中。此表列出了體系結構、通道和狀態資訊。
如果您的 SUSE Linux Enterprise 客戶端基於 x86_64 架構，請向下滾動頁面並立即選中此通道的複選框。
通過選中每個頻道左側的複選框，將頻道添加到 Uyuni。單擊描述左側的箭頭符號以展開產品並列出可用模塊。
點選【新增產品】開始產品同步。

添加頻道後，Uyuni 會安排頻道進行同步。根據此通道的數量和大小，這可能需要很長時間。您可以在 Web UI。
有關使用設定精靈的更多信息，請參閱參考 › 管理。
通道同步過程完成後，您可以註冊並設定客戶端。如需更多說明，請參閱客戶端設定 › 註冊結束view.

第 2 章使用 openSUSE Leap 安裝 Uyuni 代理

Uyuni Proxy 可以作為服務器擴展安裝在 openSUSE Leap 上。代理的安裝方式與客戶端相同，但在安裝過程中被指定為代理服務器。這是通過添加 Uyuni 代理模式並執行代理設置腳本來實現的。

有關 Uyuni 穩定版的更多信息，請參閱 https://www.uyuni-project.org/pages/stable-version.html.
有關 Uyuni 開發版的更多信息，請參見 https://www.uyuni-project.org/pages/devel-version.html.

2.1.鏡像Uyuni代理軟體
Uyuni 代理軟件可從 https://download.opensuse.org. 您可以將代理軟件同步到您的 Uyuni 服務器。此過程也稱為鏡像。

程序：鏡像 Uyuni Proxy 軟件

在 Uyuni 伺服器上，使用 spacewalkcommon-channels 指令建立 openSUSE Leap 和 Uyuni 代理通道。 spacewalk-common-channels 是 spacewalkutils 套件的一部分：

太空行走公共頻道\
打開使用_leap15_4 \
opensuse_leap15_4-非oss \
opensuse_leap15_4-非oss更新\
opensuse_leap15_4-更新\
opensuse_leap15_4-backports-更新\
opensuse_leap15_4-sle-更新\
opensuse_leap15_4-uyuni-客戶端\
uyuni-代理-穩定-leap-154

您也可以嘗試最新的開發版本，稱為 uyuni-proxy-devel-leap，而不是 uyuni-proxy-stable-leap-154 版本。有關更多信息，請參閱客戶端配置 › 客戶端-opensuseleap。

2.2.註冊 openSUSE Leap 系統
首先在物理機或虛擬機上安裝 openSUSE Leap。為確保代理可通過網絡訪問，在開始安裝之前，您必須在 openSUSE Leap 系統上具有可解析的完全限定域名 (FQDN)。您可以通過導航到系統 › 網絡設置 › 主機名/DNS 使用 YaST 配置 FQDN。
當您在代理上安裝好openSUSE Leap並配置好FQDN後，您就可以準備好Uyuni Server，並將openSUSE Leap系統註冊為客戶端。
程序：註冊 openSUSE Leap 系統

在 Uyuni 伺服器上，建立一個啟動金鑰，其中 openSUSE Leap 作為基本通道，代理和其他通道作為子通道。有關啟動金鑰的更多信息，請參閱客戶端配置 › 啟動金鑰。
修改代理的引導腳本。確保將 Uyuni 的 GPG 密鑰添加到 ORG_GPG_KEY= 參數。例如amp樂：
ORG_GPG_KEY=uyuni-gpg-pubkey-0d20833e.key
有關詳細信息，請參閱客戶端設定：clients-opensuse.adoc[]。
使用腳本引導客戶端。有關更多信息，請參閱客戶端配置 › 註冊引導。
導航到 Salt › Keys 並接受密鑰。接受密鑰後，新代理將顯示在系統 › Overview 在最近註冊的系統部分。
導航到系統詳細信息 › 軟件 › 軟件通道，並檢查是否選擇了代理通道。

2.3.在 openSUSE Leap 上安裝 Uyuni 代理
在客戶端，使用 zypper 命令行工具或在 Uyuni 服務器上， Web 在 openSUSE Leap 上安裝代理軟件的 UI。

過程：在 openSUSE Leap 上安裝 Uyuni 代理

安裝 Uyuni 代理的模式。您可以在客戶端或服務器上執行此操作。

◦ 對於客戶端，在patterns-uyuni_proxy 中使用 zypper zypper

或者，在 Uyuni 服務器上，使用 Web 用戶界面。導航到客戶端的詳細信息選項卡，單擊軟件 › 程序包 › 安裝，並安排 patterns-uyuni_proxy 進行安裝。

1. 重新啟動客戶端。

2.4.準備代理
開始之前，請確保代理模式已正確安裝。若要驗證安裝是否成功，請在 Uyuni 伺服器上選擇pattern_uyuni_proxy 套件進行安裝。
安裝完成後會自動啟動 salt-broker 服務。該服務將 Salt 交互轉發到 Uyuni 服務器。

可以在鏈中安排 Salt 代理。在這種情況下，上游代理被命名為父級。

確保在代理上打開 TCP 端口 4505 和 4506。代理必須能夠訪問這些端口上的 Uyuni 服務器或父代理。
代理與 Uyuni 服務器共享一些 SSL 信息。您需要將證書及其密鑰從 Uyuni 服務器或父代理複製到您正在設置的代理。

程式: 複製伺服器憑證和密鑰

在您正在設置的代理上，在命令提示符下，以 root 身份為證書和密鑰創建一個目錄：
mkdir -m 700 /root/ssl-buildcd /root/ssl-build
將證書和密鑰從源複製到新目錄。在這個前amp文件中，來源位置稱為 PARENT。將其替換為正確的路徑：
scp根@ :/root/ssl-build/RHN-ORG-PRIVATE-SSL-KEY 。
scp根@ :/root/ssl-build/RHN-ORG-TRUSTED-SSL-CERT 。
scp根@ :/root/ssl-build/rhn-ca-openssl.cnf 。

為了保持安全鏈完整，Uyuni 代理功能要求 SSL 證書由與 Uyuni 服務器證書相同的 CA 簽名。不支持將不同 CA 簽名的證書用於代理和服務器。有關 Uyuni 如何處理證書的更多信息，請參閱管理 › Sslcerts。

2.5.設定代理
準備好代理程式後，請使用提供的互動式configure-proxy.sh腳本完成代理設定。

程式: 設定代理

在您正在設置的代理上，在命令提示符下，以 root 身份執行設置腳本：
配置-proxy.sh
依照提示設定代理。將欄位保留為空並鍵入 Enter 以使用方括號之間顯示的預設值。

有關腳本設置的更多信息：
烏尤尼家長
Uyuni 父級可以是另一個代理程式或伺服器。
HTTP代理
HTTP 代理使您的 Uyuni 代理能夠訪問 Web. 如果直接訪問 Web 被防火牆禁止。
追溯電子郵件
用於報告問題的電子郵件地址。
是否要導入現有證書？
答案 N。
組織
下一個問題是關於用於代理的 SSL 證書的特徵。該組織可能與服務器上使用的組織相同，除非您的代理與您的主服務器不在同一個組織中。
組織單位
這裡的默認值是代理的主機名。
城市
代理證書所附的更多信息。
狀態
代理證書所附的更多信息。
國家/地區代碼
在國家代碼字段中，輸入安裝 Uyuni 時設置的國家代碼。例如ample，如果您的代理在美國，而您的 Uyuni 在 DE，請輸入 DE 作為代理。
國家代碼必須是兩個大寫字母。有關國家/地區代碼的完整列表，請參閱 https://www.iso.org/obp/ui/#search.
Cname 別名（以空格分隔）
如果您的代理程式可以透過各種 DNS CNAME 別名訪問，請使用此選項。否則可以留空。
CA 密碼
輸入用於 Uyuni 服務器證書的密碼。
你想使用現有的 SSH 密鑰來代理 SSH-Push Salt Minion 嗎？
如果您想要重用服務器上用於 SSH-Push Salt 客戶端的 SSH 密鑰，請使用此選項。

創建和填充配置通道 rhn_proxy_config_1000010001？
接受預設 Y。
SUSE 管理器用戶名
使用與 Uyuni 服務器上相同的用戶名和密碼。
如果缺少部分，例如 CA 密鑰和公共證書，腳本會打印您必須執行的命令以集成所需的 files。當強制 file複製後，再執行configure-proxy.sh。如果在腳本執行期間收到 HTTP 錯誤，請再次執行該腳本。
configure-proxy.sh 啟動Uyuni Proxy所需的服務，例如squid、apache2、saltbroker和jabberd。

要查看代理系統及其客戶端的狀態，請單擊代理系統的詳細信息頁面
Web UI（系統 › 系統列表 › 代理，然後是系統名稱）。連接和代理子選項卡顯示各種狀態信息。
如果你想從你的 Uyuni 代理 PXE 啟動你的客戶端，你還需要從 Uyuni 服務器同步 TFTP 數據。有關此同步的更多信息，請參閱客戶端配置 › Autoinst-pxeboot。

程式: 同步專業版files 和系統信息

在代理上，在命令提示符下，以 root 身份安裝 susemanager-tftpsync-recv 包：
susemanager-tftpsync-recv 中的 zypper
在代理程式上，執行 configure-tftpsync.sh 設定腳本並輸入請求的資訊：
配置-tftpsync.sh
您需要提供 Uyuni 服務器和代理的主機名和 IP 地址。您還需要輸入代理上 tftpboot 目錄的路徑。
在服務器上，在命令提示符下，以 root 身份安裝 susemanager-tftpsync：
susemanager-tftpsync 中的 zypper

在伺服器上，執行configure-tftpsync.sh設定腳本並輸入要求的資訊：
配置-tftpsync.sh
使用您正在設定的代理程式的完全限定網域再次執行該腳本。這將建立配置，並將其上傳到 Uyuni 代理：
configure-tftpsync.sh FQDN_of_Proxy
在服務器上，開始初始同步：
鞋匠同步
您也可以在 Cobbler 內發生需要立即同步的變更後進行同步。否則 Cobbler 同步將在需要時自動運行。有關 PXE 引導的更多信息，請參閱客戶端配置 › Autoinst-pxeboot。

2.6。透過代理程式為 PXE 設定 DHCP
Uyuni 使用 Cobbler 進行客戶端配置。默認情況下安裝並激活 PXE (tftp)。客戶端必須能夠使用 DHCP 在 Uyuni 代理上找到 PXE 引導。將此 DHCP 配置用於包含要配置的客戶端的區域：
下一個伺服器：
file名稱：“pxelinux.0”

2.7.重新安裝代理
代理不包含有關連接到它的客戶端的任何信息。因此，可以隨時用新的代理替換代理。替換代理必須與其前身俱有相同的名稱和 IP 地址。
有關重新安裝代理的更多信息，請參閱安裝和升級 › 代理設定。
代理系統使用引導腳本註冊為 Salt 客戶端。
此過程描述軟件通道設置和使用激活密鑰將安裝的代理註冊為 Uyuni 客戶端。

在創建激活密鑰時選擇正確的子頻道之前，請確保您已將 openSUSE Leap 頻道與所有需要的子頻道和 Uyuni 代理頻道正確同步。

2.8。更多信息
有關 Uyuni 項目的更多信息以及下載源代碼，請參閱 https://www.uyuniproject.org/.
如需更多 Uyuni 產品文檔，請參閱 https://www.uyuni-project.org/uyuni-docs/uyuni/index.html.

要提出問題或建議對文檔進行更改，請使用文檔站點上資源菜單下的鏈接。

第 3 章 GNU 自由文檔許可證

0. 前言
本許可證的目的是使手冊、教科書或其他功能性和有用的文檔在自由的意義上“免費”：確保每個人都有復制和重新分發它的有效自由，無論是否修改它，無論是商業還是非商業. 其次，本許可證為作者和出版商保留了一種獲得其作品榮譽的方式，同時不被認為對他人所做的修改負責。
本許可證是一種“copyleft”，這意味著該文件的衍生作品本身必須在同一意義上是免費的。它補充了 GNU 通用公共許可證，後者是專為自由軟件設計的 copyleft 許可證。
我們設計此許可證是為了將其用於自由軟件的手冊，因為自由軟件需要免費文檔：自由程序應隨附提供與軟件相同的自由的手冊。但本許可不限於軟件手冊；它可以用於任何文本作品，無論主題如何，也無論它是否作為印刷書籍出版。我們建議將此許可主要用於以指導或參考為目的的作品。

1. 適用範圍和定義
本授權適用於任何媒介中的任何手冊或其他作品，其中包含版權所有者發布的聲明，表明可以根據本授權的條款進行分發。此類通知授予全球範圍內、無期限、免版稅的許可，以便在此處規定的條件下使用該作品。下面的“文檔”指任何此類手冊或作品。任何公眾成員都是被授權人，並被稱為「您」。如果您按照版權法要求許可的方式複製、修改或散佈該作品，則您接受該許可。
文檔的“修改版本”是指包含文檔或其一部分的任何作品，無論是逐字複製，還是經過修改和/或翻譯成另一種語言。
「次要部分」是文件的指定附錄或前言部分，專門處理文件的出版商或作者與文件的整體主題（或相關事項）的關係，並且不包含任何可能直接涉及的內容在整個主題內。（因此，如果該文件的一部分是數學教科書，則第二部分可能不會解釋任何數學。）這種關係可能是與主題或相關事項的歷史聯繫，或者是法律、商業、哲學、倫理的歷史聯繫。
“不變節”是某些次要節，其標題被指定為不變節的標題，在通知中說明該文檔是根據本許可證發布的。如果一個部分不符合上述 Secondary 的定義，則不允許將其指定為 Invariant。文檔可能包含零個不變部分。如果文檔沒有標識任何不變部分，則沒有。
“封面文本”是在說明文檔根據本許可發布的通知中作為封面文本或封底文本列出的某些簡短文本段落。 Front-Cover Text 最多 5 個單詞，Back-Cover Text 最多 25 個單詞。
文檔的“透明”副本是指機器可讀的副本，以一種其規範可供公眾使用的格式表示，適用於使用通用文本編輯器或（對於由像素組成的圖像）通用油漆直接修改文檔程序或（用於繪圖）一些廣泛可用的繪圖編輯器，適合輸入到文本格式器或自動翻譯成適合輸入到文本格式器的各種格式。以其他透明方式製作的副本 file 已安排標記或沒有標記以阻止或阻止讀者後續修改的格式不是透明的。如果用於任何大量文本，則圖像格式不是透明的。不“透明”的副本稱為“不透明”。
Examp透明副本的合適格式包括無標記的純 ASCII、Texinfo 輸入格式、LaTeX 輸入格式、使用公開可用的 DTD 的 SGML 或 XML，以及為人工修改而設計的符合標準的簡單 HTML、PostScript 或 PDF。前任amp透明圖像格式文件包括 PNG、XCF 和 JPG。不透明格式包括只能由專有文字處理器讀取和編輯的專有格式，DTD 和/或處理工具通常不可用的 SGML 或 XML，以及由某些文字處理器生成的機器生成的 HTML、PostScript 或 PDF僅用於輸出目的。
對於印刷書籍，“扉頁”是指扉頁本身，以及為清晰地保存本許可要求出現在扉頁中的材料而需要的後續頁面。對於沒有任何標題頁的格式的作品，“標題頁”是指靠近作品標題最突出外觀的文本，位於正文開頭之前。
“標題為 XYZ”的部分是指文檔的命名子單元，其標題恰好是 XYZ 或在將 XYZ 翻譯成另一種語言的文本後的括號中包含 XYZ。（這裡 XYZ 代表下面提到的特定部分名稱，例如“Acknowledgements”、“Dedications”、“Endorsements”或“History”。）在修改文檔時“保留此類部分的標題”意味著它根據此定義，仍然是“標題為 XYZ”的部分。
該文檔可能在聲明本許可適用於該文檔的通知旁邊包含保修免責聲明。這些保修免責聲明被視為通過引用包含在本許可中，但僅限於免責保證：這些保修免責聲明可能具有的任何其他含義均無效，並且對本許可的含義沒有影響。

2. 逐字複製
您可以在任何商業或非商業媒介上複製和分發本文檔，前提是本許可證、版權聲明以及說明本許可證適用於本文檔的許可證聲明均複製到所有副本中，並且您不添加任何其他條件本許可證的內容。您不得使用技術措施阻止或控制您製作或散佈的副本的閱讀或進一步複製。但是，您可以接受補償以換取副本。如果您分發足夠多的副本，您還必須遵守第 3 節中的條件。

3. 複製數量
如果您發布文件的印刷副本（或通常有印刷封面的介質中的副本），數量超過100，並且文檔的許可通知需要封面文本，則您必須將副本附在封面上，該封面清晰易讀地包含所有這些內容封面文字：封面文字在封面上，封底文字在封底上。兩個封面還必須清楚易讀地表明您是這些副本的出版商。封面必須呈現完整的標題，標題的所有文字都同樣突出和可見。您也可以在封面上添加其他材料。僅限於封面更改的複製，只要保留文件標題並滿足這些條件，在其他方面就可以被視為逐字複製。
如果任一封面所需的文字過於冗長而無法清晰閱讀，則應將列出的第一個（盡可能多的合理）放在實際封面上，然後將其餘的繼續放在相鄰的頁面上。
如果您發布或分發文檔編號超過 100 個的不透明副本，您必須在每個不透明副本中包含一個機器可讀的透明副本，或者在每個不透明副本中或在每個不透明副本中聲明一個計算機網絡位置，通用網絡從該位置-使用公共可以使用公共標準網絡協議下載文檔的完整透明副本，無需添加材料。如果您使用後一種選擇，則在開始大量分發不透明副本時，您必須採取合理謹慎的步驟，以確保此透明副本在您最後一次分發不透明副本後至少一年後仍可在指定位置訪問。該版本的不透明副本（直接或通過您的代理或零售商）向公眾公開。
要求但不要求您在重新分發任何大量副本之前與文檔的作者聯繫，讓他們有機會為您提供文檔的更新版本。

4. 修改
您可以根據上述第 2 節和第 3 節的條件複製和分發文檔的修改版本，前提是您完全根據本許可發布修改版本，修改版本充當文檔的角色，從而許可分發和修改修改後的版本給擁有它的副本的人。此外，您必須在修改版中執行以下操作：
A. 在標題頁（和封面，如果有的話）中使用與文件不同的標題，也不同於以前版本的標題（如果有的話，應該在文件的歷史部分列出） . 如果該版本的原始出版商允許，您可以使用與以前版本相同的標題。
B. 在標題頁上列出作為作者，負責修改版本中的修改的作者身份的一個或多個個人或實體，以及文檔的至少五位主要作者（所有主要作者，如果它有少於五個），除非他們讓您免於此要求。
C. 在標題頁上註明修改版本的發布者的名稱，作為發布者。
D. 保留文檔的所有版權聲明。
E. 在其他版權聲明旁邊為您的修改添加適當的版權聲明。
F. 在版權聲明之後立即包括一個許可聲明，允許公眾根據本許可的條款使用修改版，格式如下面的附錄所示。
G. 在該許可通知中保留文檔許可通知中給出的不變部分和所需封面文本的完整列表。
H. 包括本許可證的未經更改的副本。
I. 保留標題為“歷史”的部分，保留其標題，並在其中添加一個項目，至少說明標題頁上給出的修改版本的標題、年份、新作者和出版商。如果文檔中沒有標題為“歷史”的部分，請創建一個說明文檔標題頁上給出的文檔的標題、年份、作者和出版商，然後添加一個描述修改版本的項目，如上句所述。
J. 保留文檔中給定的網絡位置（如果有），以供公眾訪問文檔的透明副本，同樣保留文檔中給出的網絡位置，以用於其所基於的先前版本。這些可以放在“歷史”部分。您可以省略在文檔本身之前至少四年出版的作品的網絡位置，或者如果它所引用版本的原始出版商給予許可。
K. 對於標題為“致謝”或“奉獻”的任何部分，保留該部分的標題，並在該部分中保留其中給出的每個貢獻者致謝和/或奉獻的所有內容和語氣。
L. 保留文檔的所有不變部分，在其文本和標題中保持不變。章節編號或同等內容不被視為章節標題的一部分。
M. 刪除任何標題為“背書”的部分。這樣的部分可能不包括在修改版本中。
N. 不要將任何現有章節重新命名為“背書”或與任何不變章節發生標題衝突。
O. 保留任何保修免責聲明。

如果修改後的版本包括符合次要部分的新的前面部分或附錄，並且不包含從文檔中復制的材料，您可以選擇將這些部分中的部分或全部指定為不變。為此，請將它們的標題添加到修改版許可聲明中的不變部分列表中。這些標題必須與任何其他章節標題不同。
您可以添加一個標題為“背書”的部分，前提是它只包含各方對您的修改版本的背書——例如ample, 同行的陳述view 或者該文本已被組織批准為標準的權威定義。
您可以將最多 25 個單字的段落作為封面文本，將最多 XNUMX 個單字的段落作為封底文本添加到修改版本中封面文本清單的末尾。任何一個實體（或透過其安排）只能添加一段封面文字和一段封底文字。如果文件已包含相同封面的封面文本，且該封面文本由您先前新增或由您代表的相同實體做出安排，則您不得新增其他內容；但是你
經添加舊版本的前發布者明確許可，可以替換舊版本。
本文檔的作者和出版商並未根據本許可許可使用他們的名字進行宣傳，或斷言或暗示對任何修改版本的認可。

5. 合併文件
您可以根據上述第 4 節中為修改版本定義的條款將本文檔與根據本許可發布的其他文檔組合，前提是您在組合中包含所有未修改的原始文檔的所有不變部分，並將它們全部列出作為您在其許可通知中的組合作品的不變部分，並且您保留其所有保修免責聲明。
合併後的作品只需要包含一份本許可證，多個相同的不變部分可以用一個副本替換。如果有多個同名但內容不同的 Invariant Sections，則通過在其末尾添加該部分的原始作者或出版商的名稱（如果已知），使每個此類部分的標題唯一，或者添加一個唯一編號。對組合作品的許可通知中不變章節列表中的章節標題進行相同的調整。
在組合中，您必須將各種原始文件中的任何一個名為“歷史”的部分組合在一起，形成一個名為“歷史”的部分；同樣，將標題為“致謝”的任何部分和標題為“奉獻”的任何部分結合起來。您必須刪除所有標題為“背書”的部分。

6. 文件收集
您可以製作一個包含文檔和根據本許可發布的其他文檔的集合，並使用包含在集合中的單個副本替換各種文檔中的本許可的單個副本，前提是您遵守本許可的規則在所有其他方面逐字複製每份文件。
您可以從此類集合中提取單個文檔，並根據本許可單獨分發它，前提是您將本許可的副本插入到提取的文檔中，並在與該文檔的逐字複製相關的所有其他方面遵循本許可。

7. 與獨立作品的聚合
如果彙編產生的版權不用於限制合法權利，則在存儲或分發介質的捲中或上的文檔或其衍生文件與其他單獨和獨立的文檔或作品的彙編稱為“集合”超出個人作品允許範圍的編輯用戶。當文檔包含在集合中時，本許可不適用於集合中的其他作品，這些作品本身不是文檔的衍生作品。
如果第 3 節的封面文字要求適用於文件的這些副本，則如果文件少於整個聚合的一半，則文件的封面文字可以放置在將文件括在聚合內的封面上，或者如果文件為電子形式，則封面的電子等效項。否則，它們必須出現在支撐整個聚合體的印刷封面上。

8. 翻譯
翻譯被視為一種修改，因此您可以根據第 4 節的條款分發文檔的翻譯。用翻譯替換不變節需要其版權所有者的特別許可，但您可以包括部分或全部不變節的翻譯，除了這些不變部分的原始版本。您可以包含本許可的翻譯版本、文檔中的所有許可通知以及任何保修免責聲明，前提是您還包含本許可的英文原始版本以及這些通知和免責聲明的原始版本。如果本許可的翻譯版本與原始版本或通知或免責聲明存在分歧，以原始版本為準。
如果文檔中的某個部分標題為“致謝”、“奉獻”或“歷史”，則保留其標題（第 4 部分）的要求（第 1 部分）通常需要更改實際標題。

9. 終止
除非本許可明確規定，否則您不得複制、修改、再許可或分發文檔。任何其他復制、修改、再許可或分發文檔的嘗試均無效，並將自動終止您在本許可下的權利。但是，根據本許可從您那裡收到副本或權利的各方將不會終止其許可，只要這些各方完全遵守。

10. 本許可證的未來修訂
自由軟件基金會可能會不時發布 GNU 自由文檔許可證的新修訂版本。這些新版本在精神上與當前版本相似，但在解決新問題或疑慮的細節上可能有所不同。看 http://www.gnu.org/copyleft/.
許可證的每個版本都有一個可區分的版本號。如果文檔指定本許可證的特定編號版本“或任何更高版本”適用於它，您可以選擇遵循該指定版本或已發布的任何更高版本的條款和條件（不是作為草案）由自由軟件基金會。如果文檔沒有指定本許可證的版本號，您可以選擇自由軟件基金會曾經發布過的任何版本（不是草稿）。

如果您有不變的部分、封面文字和封底文本，請將「替換為…文字」。與此一致：

不變部分為“列出其標題”，封面文字為“清單”，封底文字為“清單”。
如果您有沒有封面文字的不變部分，或三者的其他組合，請合併這兩個替代方案以適應情況。
如果您的文件包含重要的 examp程式碼文件，我們建議釋放這些 examp檔案在您選擇的自由軟體授權（例如 GNU 通用公共授權）下並行運行，以允許它們在自由軟體中使用。

第 3 章 GNU 自由文檔授權 |烏尤尼 2022.12