Command line arguments zh TW
ASF支援一些能夠影響程式執行的命令列引數。 進階使用者可以使用這些引數，來定義程式的執行方式。 相較於使用ASF.json設定檔的預設方式，命令列引數可用於核心初始化（例如--path）、平台特定設定（例如--system-required）或敏感性資料（例如--cryptkey）。
使用方法取決於您的作業系統以及ASF的版本。
Generic版本：
dotnet ArchiSteamFarm.dll --引數 --另一個引數Windows：
.\ArchiSteamFarm.exe --引數 --另一個引數Linux/macOS：
./ArchiSteamFarm --引數 --另一個引數命令列引數也可用於通用輔助腳本中，例如ArchiSteamFarm.cmd或ArchiSteamFarm.sh。 除此之外，如我們的管理及Docker章節中所述，您也可使用ASF_ARGS環境屬性。
若您的引數中存在空格，別忘了使用引號將其括住。 兩個錯誤的範例：
./ArchiSteamFarm --path /home/archi/My Downloads/ASF # 這是錯的！
./ArchiSteamFarm --path=/home/archi/My Downloads/ASF # 這是錯的！下面兩個才是正確的：
./ArchiSteamFarm --path "/home/archi/My Downloads/ASF" # 這樣才正確
./ArchiSteamFarm "--path=/home/archi/My Downloads/ASF" # 這樣才正確--cryptkey<key>或--cryptkey=<key>⸺將以自訂金鑰<key>啟動ASF。 此選項將會影響安全性，並使ASF使用您的自訂金鑰<key>，而不是程式中硬編碼的預設值。 因為此屬性會影響預設加密鍵（用於加密）及鹽（用於雜湊），請注意使用此金鑰加密／雜湊出的一切，ASF在每次執行時都需要給入相同的值。
<key>不要求長度或字元，但出於安全原因，我們建議選擇足夠長的通行片語，例如隨機的32個字元，在Linux上使用tr -dc A-Za-z0-9 < /dev/urandom | head -c 32; echo命令可以獲得。
需要再提一點，還有另外兩種方法可以提供此詳細資料：--cryptkey-file與--input-cryptkey。
由於此屬性的性質，它還能透過宣告ASF_CRYPTKEY環境變數來設定cryptkey，這更適合希望在程序引數中，不包含敏感資訊的使用者。
--cryptkey-file<path>或--cryptkey-file=<path>⸺將使用從<path>檔案中讀取的自訂加密金鑰<path>啟動ASF。 這與上述說明的--cryptkey<key>的目的相同。但機制不同，因為此屬性是從<path>讀取<key>。 若您將本引數與--path一同使用，請先宣告--path以使相對路徑能夠正常運作。
由於此屬性的性質，它還能透過宣告ASF_CRYPTKEY_FILE環境變數來設定cryptkey檔案，這更適合希望在程序引數中，不包含敏感資訊的使用者。
--ignore-unsupported-environment⸺使ASF忽略在不支援環境中執行的各種問題。而在原本的情形下，會顯示程式出錯並強制退出。 不支援包含例如在linux-x64上執行適用於win-x64版本的組建等的情形。 雖然此旗標使ASF能夠嘗試在這些情境中執行，但請注意，我們不正式支援此行為。若您強制ASF這樣做，後果自負。 請格外注意，所有不受支援的環境皆能被修正。 我們強烈建議從根本上修正問題，而非去使用這個引數。
--input-cryptkey⸺使ASF在啟動過程詢問--cryptkey。 若您不希望在任何地方儲存cryptkey，例如環境變數或檔案中，而要在每次ASF執行時手動輸入，則可以使用此選項。
--minimized⸺使ASF在啟動後立刻最小化控制台視窗。 主要是在自動啟動的情境中非常好用，但仍可用於其他地方。 此開關目前只在Windows設備中有效。
--network-group <group>或--network-group=<group>⸺使ASF使用<group>值的自訂網路群組來初始化其限制器。 這個選項會影響執行多個實例的ASF，使用此選項指定的實例只會與相同網路群組的實例相互分享資訊，而與其他實例獨立。 這個選項會影響執行多個實例的ASF，使用此選項指定的實例只會與相同網路群組的實例相互分享資訊，而與其他實例獨立。 請注意，在使用自訂網路群組時，這是本機電腦中的唯一識別碼，ASF將不考慮任何其他細節。例如WebProxy的值，您可以使用不同的WebProxy值來執行兩個實例，但它們仍會互相影響。
由於此屬性的性質，它還能透過宣告ASF_NETWORK_GROUP環境變數來設定其值，這更適合希望在程序引數中，不包含敏感資訊的使用者。
--no-config-migrate⸺在預設情形下，ASF會自動將您的設定檔遷移成最新的語法。 遷移包含：將廢止的屬性轉換成最新的屬性，刪除值為預設的屬性（因為它們沒有意義），以及清理檔案內容（修正縮排等）。 這通常是個好方法，但您可能會遇到特殊情形，以至於希望ASF不會去自動覆蓋設定檔。 舉例來說，您可能想要對設定檔chmod 400（僅擁有者可讀取），或使用chattr +i禁止任何人寫入，來作為安全措施。 一般而言，我們建議保留啟用設定遷移，但如果您有特定的理由停用它，並希望ASF不遷移設定，您可以使用此開關來達成。 但請注意，為ASF提供正確的設定，現在已成為了您自己的新責任，特別是有關未來版本的功能棄用及重構。
--no-config-watch⸺在預設情形下，ASF會在您的config資料夾中設定FileSystemWatcher，以監聽更動檔案的事件 ，因此才能夠動態適應這些改動。 舉例來說，在刪除設定檔後停止Bot，修改設定後重新啟動Bot，或在您將序號加入至config資料夾後，載入至背景序號啟動器中。 這個開關允許您停用這個行為，使ASF完全忽略config資料夾中的任何更改，您需要在適合的時機手動執行相關操作（通常是重新啟動程序）。 我們建議保持啟用config事件監聽，但如果您有特殊原因停用它，並希望ASF不這樣做，就可以使用此開關來達成。
--no-restart⸺這個開關主要由Docker容器所使用，它會強制將AutoRestart設定成false。 除非您有特殊需求，否則您應該直接在設定中設定AutoRestart屬性。 這個開關使Docker腳本不需要修改您的全域設定，來適應它的環境。 當然，如果是在腳本中執行ASF，您也可以使用此開關（否則您最好使用全域設定屬性）。
--no-steam-parental-generation⸺在預設情形下，ASF會自動嘗試生成Steam家長監護PIN碼，如SteamParentalCode設定屬性中所述。 但由於這可能需要過多的作業系統資源，因此這個開關使您能夠停用此行為，這將使ASF跳過自動生成，並直接向使用者詢問PIN碼，與一般情形下的自動生成失敗時相同。 一般而言，我們建議保留啟用生成，除非您有特定的理由停用它，並希望ASF不生成代碼，您可以使用此開關來達成。
--path <path>或--path=<path>⸺在預設情形下，ASF總是會在啟動後，使用程式本身所在的資料夾。 By specifying this argument, ASF will navigate to given directory after initialization, which allows you to use custom path for various application parts (including config, logs, plugins and www directories, as well as NLog.config file), without a need of duplicating binary in the same place. 若您想將二進制檔案和實際使用的設定檔分開，這可能會非常有用。就像是Linux的封裝機制一樣：這樣您就可以在多個設定檔間，共用一個（最新的）二進制檔案。 這個路徑既可以是依據ASF二進制檔案所在位置的相對路徑，亦可以是絕對路徑。 請注意，這個指令會指向新的「ASF主資料夾」：與原本的ASF具有相同的資料夾結構，其中包含config資料夾，請參閱下面的說明範例。
由於此屬性的性質，它還能透過宣告ASF_PATH環境變數來設定路徑，這更適合希望在程序引數中，不包含敏感資訊的使用者。
如果您考慮使用此命令列引數來執行多個ASF實例，我們建議您閱讀我們的相容性頁面。
範例：
dotnet /opt/ASF/ArchiSteamFarm.dll --path /opt/TargetDirectory # 使用絕對路徑
dotnet /opt/ASF/ArchiSteamFarm.dll --path ../TargetDirectory # 或使用相對路徑
ASF_PATH=/opt/TargetDirectory dotnet /opt/ASF/ArchiSteamFarm.dll # 或使用環境變數├── /opt
│ ├── ASF
│ │ ├── ArchiSteamFarm.dll
│ │ └── ...
│ └── TargetDirectory
│ ├── config
│ ├── logs（自動產生）
│ ├── plugins（選擇性）
│ ├── www（選擇性）
│ ├── log.txt（自動產生）
│ └── NLog.config（選擇性）
└── ...
--process-required⸺在預設情形下，ASF會在沒有Bot執行時關閉，使用這個開關會停用此行為。 這項功能與IPC一起使用時特別有用，大多數使用者都會希望他們的Web服務不管在多少個Bot啟用時，都能夠正常執行。 若您正在使用IPC，或需要ASF程序一直執行到您手動關閉它，那麼您就該使用此選項。
若您沒有打算執行IPC，則這個選項對您來說沒有用處，因為您可以在需要時重新啟動程序（與始終監聽來傳送指令的ASF Web伺服器相反）。
--service⸺這個開關主要由systemd服務所使用，它會強制將Headless設定成true。 除非您有特殊需求，否則您應該直接在設定中設定Headless屬性。 這個開關使systemd服務不需要修改您的全域設定，來適應它的環境。 當然，如果您有類似需求，您也可以使用此開關（否則您最好使用全域設定屬性）。
--system-required⸺使用這個開關，將使ASF嘗試通知作業系統，表明本程序需要在系統執行期間，保持啟動與正常執行狀態。 目前這個開關只對Windows設備有效，只要程序正在執行，它就會阻止您的系統進入睡眠模式。 當您在夜間使用桌機或筆電掛卡時，這個功能是相當實用的，因為ASF將會在掛卡期間讓您的系統保持喚醒狀態。一旦ASF完成掛卡，它會像平常一樣自動關閉，使您的系統可以再次進入睡眠模式，以此節省電力消耗。
請注意，要正確地使ASF自動關閉，您還需要其他設定：特別是避免使用--process-required，並確保您的所有Bot都在FarmingPreferences中設定了ShutdownOnFarmingFinished。 當然，自動關閉只是這個功能的其中一種用法，因為您還可以配合--process-required使用，讓您的系統在ASF啟動之後永遠地保持喚醒狀態。
