Command line arguments ru RU

Аргументы командной строки

ASF поддерживает несколько аргументов командной строки, которые влияют на работу программы. Они могут использоваться опытными пользователями для изменения поведения программы. По сравнению с обычной настройкой через файл конфигурации ASF.json, аргументы командной строки используются для инициализации ядра (например, --path), специфичных для данной платформы настроек (например, --system-required) или конфиденциальных данных (например, --cryptkey).

---

Использование

Способ использования аргументов зависит от вашей операционной системы и варианта ASF.

Общий:

dotnet ArchiSteamFarm.dll --argument --otherOne

Windows:

.\ArchiSteamFarm.exe --argument --otherOne

Linux/macOS:

./ArchiSteamFarm --argument --otherOne

Аргументы командной строки также поддерживаются во вспомогательных скриптах, таких как ArchiSteamFarm.cmd или ArchiSteamFarm.sh. В дополнении к этому, при использовании вспомогательных скриптов вы можете использовать переменные окружения ASF_ARGS, как указано в разделе [Docker](https://github. com/JustArchiNET/ArchiSteamFarm/wiki/Docker-ru-RU#user-content-Аргументы-командной-строки).

Если ваш аргумент содержит пробелы, не забудьте заключить его в кавычки. Эти два примера неправильные:

./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> - запустит ASF с пользовательским значением ключа шифрования <key>. Эта настройка влияет на безопасность и ASF будет использовать данный ключ шифрования <key> вместо внедрённого в исполняемый файл. Поскольку эта настройка влияет на ключ шифрования по умолчанию (для шифрования), а также на соль (для хеширования), не забывайте, что для любого шифрования/хеширования этот ключ должен передаваться ASF при каждом запуске.

If you want to provide <key> from a file, use --cryptkey-file for that purpose instead, explained below.

Из-за природы этого параметра также есть возможность задавать ключ шифрования путём задания переменной среды ASF_CRYPTKEY, это может оказаться более подходящим для людей, которые хотели бы избежать наличия конфиденциальной информации в аргументах процесса.

---

--cryptkey-file <path> or --cryptkey-file=<path> - will start ASF with custom cryptographic key read from <path> file. This serves the same purpose as --cryptkey <key> explained above, only the mechanism differs, as this property will read <key> from provided <path> instead.

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

---

--ignore-unsupported-environment - will cause ASF to ignore problems related to running in unsupported environment, which normally is signalized with an error and a forced exit. Unsupported environment includes for example running .NET Framework build on platform that could be running .NET (Core) build instead. While this flag will allow ASF to attempt running in such scenarios, be advised that we do not support those officially and you're forcing ASF to do it entirely at your own risk. As of today, all of the unsupported environment scenarios can be corrected, such as running generic build instead of generic-netf. We strongly recommend to fix the outstanding problems instead of declaring this argument.

---

--network-group <group> либо --network-group=<group> - указывает ASF использовать ограничители запросов для пользовательской сетевой группы с именем <group>. Этот аргумент влияет на работу ASF при запуске нескольких экземпляров программы, указывая что этот экземпляр зависит только от других экземпляров в той же сетевой группе, и не зависит от остальных. Обычно вам стоит указывать этот аргумент если вы перенаправляете запросы от ASF с помощью внешних механизмов (например, различных IP-адресов), и хотите сами задавать сетевую группу, не полагаясь на автоматическое определение ASF (которое на данный момент учитывает только значение WebProxy). Имейте в виду, что используемая сетевая группа является уникальным идентификатором в пределах данной машины, и ASF не будет учитывать прочие детали, такие как значение WebProxy, позволяя вам, например, запустить два экземпляра программы с разными значениями WebProxy и тем не менее зависящие друг от друга.

Из-за природы этого параметра также есть возможность задавать его значение путём задания переменной среды ASF_NETWORK_GROUP, это может оказаться более подходящим для людей, которые хотели бы избежать наличия конфиденциальной информации в аргументах процесса.

---

--no-config-migrate - по умолчанию ASF автоматически перенесет ваши файлы конфигурации на последнюю версию синтаксиса. Перенос включает преобразование устаревших свойств в новые, удаление свойств со значениями по умолчанию (поскольку они не действуют), а также очистку файла в целом (исправление отступов и тому подобное). Это почти всегда хорошая идея, но у вас может быть особая ситуация, когда вы предпочитаете, чтобы ASF никогда не перезаписывал файлы конфигурации автоматически. Например, вы можете сделать chmod 400 свои файлы конфигурации (права на чтение только для владельца) или поместить поверх них chattr + i, в результате запретив доступ на запись для всех, например в качестве меры безопасности. Обычно мы рекомендуем оставить перенос конфигурации включенным, но если у вас есть особая причина для его отключения и вы предпочитаете, чтобы ASF этого не делал, вы можете использовать этот переключатель для достижения этой цели.

---

--no-config-watch - по умолчанию ASF устанавливает FileSystemWatcher в вашем каталоге config, чтобы отслеживать события, связанные с изменениями файлов, поэтому он может интерактивно адаптироваться к ним. Например, это включает в себя остановку ботов при удалении конфигурации, перезапуск бота при изменении конфигурации или загрузку ключей в BGR после того, как вы поместите их в каталог config. Этот переключатель позволяет вам отключить такое поведение, которое заставит ASF полностью игнорировать все изменения в каталоге config, требуя от вас выполнения таких действий вручную, если вы сочтете нужным. Обычно мы рекомендуем оставить конфигурационные события включенными, но если у вас есть особая причина для их отключения и вместо этого вы предпочитаете, чтобы ASF этого не делал, вы можете использовать этот переключатель для достижения этой цели.

---

--no-restart - данный параметр используется для контейнеров Docker и принудительно задаёт параметру AutoRestart значение false. Если у вас нет особой необходимости в этой команде, вам следует вместо этого настроить свойство AutoRestart прямо в вашей конфигурации. Этот переключатель находится здесь, поэтому нашему docker-скрипту не нужно будет трогать вашу глобальную конфигурацию, чтобы адаптировать ее к своей собственной среде. Разумеется, если вы запускаете ASF из скрипта, возможно вы захотите тоже воспользоваться этим аргументом (в противном случае лучше использовать параметр глобальной конфигурации).

---

--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> или --path=<path> - ASF всегда использует папку из которой был запущен. При использовании этого аргумента ASF будет переходить после инициализации в указанную папку, что позволяет вам использовать произвольный путь для различных частей приложения (включая папки config, plugins и www, а также файл NLog.config), без необходимости дублировать исполняемый файл в заданном месте. Это может оказаться особенно полезно если вы хотите разделить исполняемые файлы от собственно файлов конфигурации, как это делается в пакетах 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 (generated)
│           ├── plugins (optional)
│           ├── www (optional)
│           ├── log.txt (generated)
│           └── NLog.config (optional)
└── ...

---

--process-required - использование этого аргумента запретит выключение ASF в ситуации когда нет запущенных ботов. Отсутствие автоматического выключения особенно полезно в сочетании с IPC, поскольку большинство пользователей будут ожидать что веб-интерфейс будет работать независимо от количества запущенных ботов. Если вы пользуетесь IPC или вам по другой причине нужно чтобы ASF продолжал работу пока вы не выключите его сами, это как раз то, что вам надо.

Если вы не планируете использовать IPC, этот аргумент выглядит довольно бесполезным для вас, поскольку вы всегда можете заново запустить процесс ASF когда он вам нужен (в отличии от серверного использования, когда вы ожидаете что ASF продолжит всё время ожидать от вас новых команд).

---

--service - этот переключатель в основном используется нашей службой systemd и устанавливает для Headless значение true. Если у вас нет особой необходимости в этой команде, вам следует вместо этого настроить свойство Headless прямо в вашей конфигурации. Этот переключатель находится здесь, поэтому нашей службе systemd не нужно будет трогать вашу глобальную конфигурацию, чтобы адаптировать ее к своей собственной среде. Конечно, если у вас есть потребность в этой команде, вы также можете использовать этот переключатель (в противном случае вам лучше использовать глобальное свойство конфигурации).

---

--system-required - указание этого аргумента заставит ASF попытаться сообщить ОС что этому процессу требуется чтобы система была запущена в течение всей его работы. На данный момент этот параметр имеет эффект только на машинах использующих Windows, где он запретит системе переходить в режим сна пока запущен процесс. Это может оказаться особенно полезно если вы фармите на вашем ПК или ноутбуке ночью, поскольку ASF сможет оставить вашу систему запущенной пока он фармит, а после окончания работы ASF завершится, и позволит вашей системе снова перейти в режим сна, позволяя сэкономить электроэнергию когда фарм завершен.

Помните, что для штатного автоматического завершения ASF могут понадобиться другие настройки - в особенности отсутствие аргумента --process-required и наличие у всех ботов включенного параметра ShutdownOnFarmingFinished. Конечно же, автоматическое завершение это только одно из возможных применений этой функции и не является обязательным, поскольку вы можете использовать этот аргумент совместно с например --process-required, фактически оставив вашу систему постоянно включенной после запуска ASF.