Command line arguments tr TR

Komut satırı argümanları

ASF, program çalışma zamanını etkileyebilecek çeşitli komut satırı bağımsız değişkenleri için destek içerir. Bunlar, programın nasıl çalışması gerektiğini belirtmek için ileri düzey kullanıcılar tarafından kullanılabilir. ASF.json yapılandırma dosyasının varsayılan yöntemiyle karşılaştırıldığında, komut satırı bağımsız değişkenleri çekirdek başlatma (ör. --path), platforma özgü ayarlar (ör. --system-required) veya hassas veriler (ör. --cryptkey) için kullanılır.

Kullanım

Kullanım işletim sisteminize ve ASF zevkinize göre değişir.

Genel:

dotnet ArchiSteamFarm.dll --argüman --başkaArgüman

Windows:

.\ArchiSteamFarm.exe --argüman --başkaArgüman

Linux/macOS:

./ArchiSteamFarm --argüman --başkaArgüman

Komut satırı argümanları ArchiSteamFarm.cmd veya ArchiSteamFarm.sh gibi genel yardımcı betik dosyalarında da kullanılır. Buna ek olarak, yönetim ve docker bölümlerimizde belirtildiği gibi ASF_ARGS ortam özelliğini de kullanabilirsiniz.

Eğer argümanınızda boşluklar varsa tırnak içinde kullanmayı unutmayın. Şu ikisi hatalıdır:

./ArchiSteamFarm --path /home/archi/My Downloads/ASF # Kötü!
./ArchiSteamFarm --path=/home/archi/My Downloads/ASF # Kötü!

Ancak şu ikisi tamamen hatasızdır:

./ArchiSteamFarm --path "/home/archi/My Downloads/ASF" # Doğru
./ArchiSteamFarm "--path=/home/archi/My Downloads/ASF" # Doğru

Argümanlar

--cryptkey <key> veya --cryptkey=<key> - ASF'yi <key> değerinde verilen özel kriptografik anahtar ile başlatır. Bu seçenek güvenliği etkiler ve ASF'nin içine gömülü kriptografik anahtar yerine sizin verdiğiniz özel <key> anahtarı kullanılır. Bu değişken varsayılan şifreleme anahtarını (şifreleme için) ve salt değerini (hashing için) değiştirdiği için, sizin sunduğunuz anahtarla şifrelenen/hashlenen her şeyi kullanabilmek için her defasında ASF'ye bu anahtarı vermek zorunda olacağınızı unutmayın.

<key> uzunluğu veya karakterlerine ilişkin bir zorunluluk yoktur, ancak güvenlik nedenleriyle örneğin rastgele 32 karakterden oluşan yeterince uzun bir parola seçmenizi tavsiye ederiz. Bu işlemi gerçekleştirmek için Linux üzerinde tr -dc A-Za-z0-9 < /dev/urandom | head -c 32; echo komutunu kullanabilirsiniz.

Bu ayrıntıyı sağlamanın iki yolu daha olduğunu belirtmek güzel:--cryptkey-file and --input-cryptkey.

Bu değişkenin doğası gereği, cryptkey'i ASF_CRYPTKEY ortam değişkeni ile de değiştirebilirsiniz, işlem argümanlarında hassas bilgilerin bulunmamasını isteyen kişiler için daha ideal olur.

--cryptkey-file <path> ve --cryptkey-file=<path> - ASF'yi <path> dosyasından okunan özel şifreleme anahtarı ile başlatır. Bu, yukarıda açıklanan --cryptkey <key> ile aynı amaca hizmet eder, yalnızca mekanizma farklıdır, çünkü bu özellik bunun yerine <key> sağlanandan <path> okuyacaktır. If you're using this together with --path, consider the fact that relative path will be different depending on the order of arguments, i.e. whether you switch --path before or after --cryptkey-file.

Bu özelliğin doğası gereği, işlem bağımsız değişkenlerinde hassas ayrıntılardan kaçınmak isteyen kişiler için daha uygun olabilecek ASF_CRYPTKEY_FILE ortam değişkeni bildirerek cryptkey dosyasını ayarlamak da mümkündür.

--ignore-unsupported-environment - ASF'nin normalde bir hata ve zorunlu çıkışla işaretlenen desteklenmeyen ortamda çalışmayla ilgili sorunları görmezden gelmesine neden olur. Desteklenmeyen ortamlar, örneğin linux-x64 üzerinde win-x64 OS özel derlemesinin çalıştırılması gibi durumları içerir. Bu bayrak ASF'nin bu tür senaryolarda koşmaya çalışmasına izin verecek olsa da, bunları resmi olarak desteklemediğimizi ve ASF'yi tamamen kendi sorumluluğunuzda yapmaya zorladığınızı unutmayın. It's important to point out that all of the unsupported environment scenarios can be corrected. Bu argümanı beyan etmek yerine öne çıkan sorunları düzeltmenizi şiddetle tavsiye ederiz.

--input-cryptkey - ASF'nin başlatma sırasında --cryptkey hakkında soru sormasını sağlar. Bu seçenek, ister ortam değişkenlerinde ister bir dosyada olsun, şifreleme anahtarı sağlamak yerine, herhangi bir yere kaydedilmemesini ve bunun yerine her ASF çalıştırılmasında el ile girilmesini tercih ediyorsanız sizin için yararlı olabilir.

--minimized - ASF konsol penceresinin başlatıldıktan kısa bir süre sonra simge durumuna küçültülmesini sağlar. Esas olarak otomatik başlatma senaryolarında kullanışlıdır, ancak bunların dışında da kullanılabilir. This option requires appropriate environment support - it may not work properly in all possible scenarios.

--network-group <group> or --network-group=<group> - will cause ASF to init its limiters with a custom network group of <group> value. This option affects running ASF in multiple instances by signalizing that given instance is dependent only on instances sharing the same network group, and independent of the rest. Typically you want to use this property only if you're routing ASF requests through custom mechanism (e.g. different IP addresses) and you want to set networking groups yourself, without relying on ASF to do it automatically (which currently includes taking into account WebProxy only). Keep in mind that when using a custom network group, this is unique identifier within the local machine, and ASF will not take into account any other details, such as WebProxy value, allowing you to e.g. start two instances with different WebProxy values which are still dependent on each other.

Due to the nature of this property, it's also possible to set the value by declaring ASF_NETWORK_GROUP environment variable, which may be more appropriate for people that would want to avoid sensitive details in the process arguments.

--no-config-migrate - by default ASF will automatically migrate your config files to latest syntax. Migration includes conversion of deprecated properties into latest ones, removing properties with default values (as they have no effect), as well as cleaning up the file in general (correcting indentation and likewise). This is almost always a good idea, but you might have a particular situation where you'd prefer ASF to never overwrite the config files automatically. For example, you might want to chmod 400 your config files (read permission for the owner only) or put chattr +i over them, in result denying write access for everyone, e.g. as a security measure. Usually we recommend to keep the config migration enabled, but if you have a particular reason for disabling it and would instead prefer ASF to not do that, you can use this switch for achieving that purpose. Keep in mind however, that providing correct settings to ASF will become from now on your new responsibility, especially in regards to deprecations and refactors of properties in future ASF versions.

--no-config-watch - by default ASF sets up a FileSystemWatcher over your config directory in order to listen for events related to file changes, so it can interactively adapt to them. For example, this includes stopping bots on config deletion, restarting bot on config being changed, or loading keys into BGR once you drop them into the config directory. This switch allows you to disable such behaviour, which will cause ASF to completely ignore all the changes in config directory, requiring from you to do such actions manually, if deemed appropriate (which usually means restarting the process). Yapılandırma olaylarını etkin tutmanızı tavsiye ederiz, ancak bunları devre dışı bırakmak için belirli bir nedeniniz varsa ve bunun yerine asf'nin bunu yapmamasını tercih ediyorsanız, bu anahtarı bu amaca ulaşmak için kullanabilirsiniz.

--no-restart - this switch is mainly used by our docker containers and forces AutoRestart of false. Unless you have a particular need, you should instead configure AutoRestart property directly in your config. This switch is here so our docker script won't need to touch your global config in order to adapt it to its own environment. Of course, if you're running ASF inside a script, you may also make use of this switch (otherwise you're better with global config property).

--no-steam-parental-generation - by default ASF will automatically attempt to generate Steam parental PINs, as described in SteamParentalCode configuration property. However, since that might require excessive amount of OS resources, this switch allows you to disable that behaviour, which will result in ASF skipping auto-generation and go straight to asking user for PIN instead, which is what would normally happen only if the auto-generation has failed. Usually we recommend to keep the generation enabled, but if you have a particular reason for disabling it and would instead prefer ASF to not do that, you can use this switch for achieving that purpose.

--path <path> or --path=<path> - ASF always navigates to its own directory on startup. 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. It may come especially useful if you'd like to separate binary from actual config, as it's done in Linux-like packaging - this way you can use one (up-to-date) binary with several different setups. The path can be either relative according to current place of ASF binary, or absolute. Keep in mind that this command points to new "ASF home" - the directory that has the same structure as original ASF, with config directory inside, see below example for explanation.

Due to the nature of this property, it's also possible to set expected path by declaring ASF_PATH environment variable, which may be more appropriate for people that would want to avoid sensitive details in the process arguments.

If you're considering using this command-line argument for running multiple instances of ASF, we recommend reading our management page on this manner.

Örnekler:

dotnet /opt/ASF/ArchiSteamFarm.dll --path /opt/TargetDirectory # Absolute path
dotnet /opt/ASF/ArchiSteamFarm.dll --path ../TargetDirectory # Relative path works as well
ASF_PATH=/opt/TargetDirectory dotnet /opt/ASF/ArchiSteamFarm.dll # Same as env variable

├── 📁 /opt
│     ├── 📁 ASF
│     │     ├── ⚙️ ArchiSteamFarm.dll
│     │     └── ...
│     └── 📁 TargetDirectory
│           ├── 📁 config
│           ├── 📁 logs (generated)
│           ├── 📁 plugins (optional)
│           ├── 📁 www (optional)
│           ├── 📄 log.txt (generated)
│           └── 📄 NLog.config (optional)
└── ...

--service - this switch is mainly used by our systemd service and forces Headless of true. Unless you have a particular need, you should instead configure Headless property directly in your config. This switch is here so our systemd service won't need to touch your global config in order to adapt it to its own environment. Of course, if you have a similar need then you may also make use of this switch (otherwise you're better with global config property).

--system-required - declaring this switch will cause ASF to try signalizing the OS that the process requires system to be up and running for its entire lifetime. Currently this switch has effect only on Windows machines where it'll forbid your system from going into sleep mode as long as the process is running. This can be proven especially useful when farming on your PC or laptop during night, as ASF will be able to keep your system awake while it's running.