Command line arguments ko KR

명령줄 인자

ASF는 프로그램 실행에 영향을 미칠 수 있는 여러 명령줄 인자에 대한 지원을 포함합니다. 이것은 프로그램이 어떻게 동작해야하는지 특정하기위한 고급사용자가 이용할 수 있습니다. ASF.json 설정 파일의 기본 방식과 비교하면, 명령줄 인자는 --path 등 주요 초기설정, --system-required 등 플랫폼 특화 설정, --cryptkey 등 민감한 데이터에 사용합니다.

---

사용법

사용중인 OS와 ASF 취향에 따라 사용법이 다릅니다.

일반:

dotnet ArchiSteamFarm.dll --인자1 --인자2

Windows:

.\ArchiSteamFarm.exe --인자1 --인자2

Linux/macOS:

./ArchiSteamFarm --인자1 --인자2

명령줄 인자는 ArchiSteamFarm.cmd나 ArchiSteamFarm.sh 같은 일반 도우미 스크립트에서도 지원합니다. 또한 ASF_ARGS 환경 속성을 사용할 수도 있으며, 이는 저희 관리 및 도커 섹션에서 설명한 바와 같습니다.

인자에 공백이 들어간다면 따옴표로 표시하는 것을 잊지마십시오. 아래 두개는 잘못되었습니다:

./ArchiSteamFarm --path /home/archi/My Downloads/ASF # Bad!
./ArchiSteamFarm --path=/home/archi/My Downloads/ASF # Bad!

하지만, 다음 두개는 완전히 정상입니다.

./ArchiSteamFarm --path "/home/archi/My Downloads/ASF" # OK
./ArchiSteamFarm "--path=/home/archi/My Downloads/ASF" # OK

인자

--cryptkey <key> 혹은 --cryptkey=<key> - <key>값의 자체 암호화 키를 가지고 ASF를 시작합니다. 이 옵션은 **보안**에 영향을 주고 ASF가 실행파일에 하드코딩된 기본 키 대신 제공된 자체 <key>키를 사용하도록 합니다. 이 속성은 암호화용 기본 암호화 키뿐 아니라 해싱용 salt 값에도 영향을 미치므로, 이 키로 암호화 또는 해싱된 모든 항목은 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> 파일에서 읽어들인 사용자 지정 암호화 키로 ASF를 시작합니다. 이는 위에서 설명한 --cryptkey <key>와 동일한 목적을 가지지만, 방식이 다릅니다. 이 속성은 대신 제공된 <path>에서 <key>을 읽어옵니다. --path와 함께 이 옵션을 사용하는 경우, 인수 순서에 따라 상대 경로가 달라질 수 있다는 점에 유의하세요. 즉, --path를 --cryptkey-file보다 앞에 두는지 뒤에 두는지에 따라 결과가 달라집니다.

이 속성의 특성상, ASF_CRYPTKEY_FILE 환경 변수를 선언하여 암호화 키 파일을 설정할 수도 있습니다. 이는 프로세스 인수에 민감한 정보를 노출하고 싶지 않은 사용자에게 더 적합할 수 있습니다.

---

--ignore-unsupported-environment - 지원되지 않는 환경에서 실행될 때 발생하는 문제를 무시하도록 합니다. 이는 원래 오류와 함께 강제 종료로 표시됩니다. 지원되지 않는 환경의 예로는 linux-x64에서 win-x64 전용 빌드를 실행하는 경우가 있습니다. 이 플래그를 사용하면 ASF가 이러한 상황에서도 실행을 시도하지만, 이는 공식적으로 지원되지 않으며 전적으로 사용자 책임 하에 강제로 실행하는 것임을 유의하세요. 중요한 점은, 지원되지 않는 환경 문제는 모두 해결할 수 있다는 것입니다. 이 인수를 선언하는 대신 남아있는 문제를 해결하실 것을 강력히 권장합니다.

---

--input-cryptkey - ASF가 시작할 때 --cryptkey를 입력하도록 요청합니다. 환경 변수나 파일에 암호화 키를 저장하는 대신, 어디에도 저장하지 않고 ASF를 실행할 때마다 직접 입력하고 싶으시다면 이 옵션이 유용할 수 있습니다.

---

--minimized - ASF 콘솔 창이 시작 직후 자동으로 최소화됩니다. 주로 자동 시작 시나리오에서 유용하지만, 그 외의 경우에도 사용할 수 있습니다. 이 옵션은 적절한 환경 지원이 필요하며, 모든 상황에서 정상적으로 작동하지 않을 수 있습니다.

---

--network-group <group> 또는 --network-group=<group> - ASF가 <group> 값으로 설정된 사용자 지정 네트워크 그룹으로 제한기(limiter)를 초기화합니다. 이 옵션은 ASF를 **다중 인스턴스**로 실행할 때 영향을 미치며, 해당 인스턴스가 동일한 네트워크 그룹을 공유하는 인스턴스에만 종속되고 나머지와는 독립적임을 나타냅니다. 일반적으로 이 속성은 사용자 지정 방식(예: 서로 다른 IP 주소)으로 ASF 요청을 라우팅하면서, ASF가 자동으로 처리하는 방식(현재는 WebProxy만 고려함)에 의존하지 않고 직접 네트워크 그룹을 설정하고 싶을 때 사용합니다. 사용자 지정 네트워크 그룹을 사용할 경우, 이는 로컬 머신 내에서 고유 식별자이며 ASF는 WebProxy 값 등 다른 세부 정보는 고려하지 않는다는 점을 유의하세요. 예를 들어 서로 다른 WebProxy 값을 가진 두 인스턴스를 실행하더라도 여전히 서로 종속된 상태로 시작할 수 있습니다.

이 속성의 특성상, ASF_NETWORK_GROUP 환경 변수를 선언하여 값을 설정할 수도 있습니다. 이는 프로세스 인수에 민감한 정보를 노출하고 싶지 않은 사용자에게 더 적합할 수 있습니다.

---

--no-config-migrate - 기본적으로 ASF는 설정 파일을 최신 형식으로 자동 전환(마이그레이션)합니다. 이 전환 작업에는 사용 중단된(deprecated) 속성을 최신 속성으로 변환하고, 기본값을 가진 속성을 제거하며(어차피 효과가 없으므로), 들여쓰기 정리 등 파일을 전반적으로 정돈하는 과정이 포함됩니다. 이는 대부분의 경우 유용하지만, ASF가 설정 파일을 절대 자동으로 덮어쓰지 않기를 원하시는 특별한 상황이 있을 수 있습니다. 예를 들어, 보안 조치로 설정 파일에 chmod 400을 적용해 소유자에게만 읽기 권한을 부여하거나, chattr +i를 적용해 모든 사용자의 쓰기 권한을 차단할 수 있습니다. 일반적으로는 설정 파일 자동 전환 기능을 활성화된 상태로 두는 것을 권장하지만, 특정한 이유로 이를 비활성화하고 ASF가 그렇게 하지 않기를 원하신다면 이 스위치를 사용하여 그 목적을 달성할 수 있습니다. 다만, 이제부터는 ASF에 올바른 설정 값을 제공하는 것이 전적으로 사용자의 책임이 된다는 점을 유의하세요. 특히 향후 ASF 버전에서 속성이 사용 중단되거나 구조가 변경될 경우 더욱 그렇습니다.

---

--no-config-watch - 기본적으로 ASF는 파일 변경 이벤트를 감지하여 즉시 대응할 수 있도록 config 디렉터리에 대해 FileSystemWatcher를 설정합니다. 예를 들어, 설정 파일이 삭제되면 봇을 중지하거나, 설정이 변경되면 봇을 재시작하거나, config 디렉터리에 파일을 넣으면 **BGR**로 키를 불러오는 등의 동작이 여기 포함됩니다. 이 스위치는 이러한 동작을 비활성화합니다. 이 경우 ASF는 config 디렉터리의 모든 변경 사항을 완전히 무시하며, 필요하다고 판단되는 작업(대체로 프로세스 재시작)을 직접 수동으로 수행해야 합니다. 일반적으로는 설정 파일 이벤트 감지 기능을 활성화된 상태로 두는 것을 권장하지만, 특정한 이유로 이를 비활성화하고 ASF가 그렇게 하지 않기를 원하신다면 이 스위치를 사용하여 그 목적을 달성할 수 있습니다.

---

--no-restart - 기본적으로 ASF는 AutoRestart 설정 속성을 따르며, 이를 사용해 필요할 때 재시작을 허용할지 여부를 지정할 수 있습니다. 저희가 제공하는 일부 솔루션은 프로세스 관리를 자체적으로 담당하며 ASF의 자동 재시작 기능과 명시적으로 호환되지 않습니다. 예를 들어 docker나 systemd에서 ASF를 실행하는 경우, 이들 시스템은 프로세스가 단순히 종료되기만을 요구하며, 필요하다고 판단될 경우 이후 재시작하는 것은 해당 시스템의 책임이기 때문입니다. 사용자 경험상 임의로 설정 파일을 수정하는 것은 바람직하지 않으므로, 이 스위치는 설정 파일에 다르게 지정되어 있더라도 AutoRestart 속성을 명시적으로 false로 초기화하여 단순히 재정의(override)합니다. 이를 통해 호환되는 AutoRestart: false 설정 파일을 따로 제공하지 않아도, ASF가 이러한 환경에서 실행 중임을 사전에 인지할 수 있습니다.

또한 --no-restart는 AutoRestart: false와 달리 restart 명령을 사용하거나 다른 방식으로 ASF 프로세스 재시작을 요청하는 것도 금지합니다. 이 스위치는 그러한 설정과 명시적으로 호환되지 않는다고 선언하는 반면, AutoRestart 속성은 단지 기본 동작만을 지정하기 때문입니다.

일반적으로는 여기서 설명한 동작을 설정 파일을 통해 제어할 수 있고, 또 그렇게 하시는 것이 좋습니다. 다만 사용자 지정 스크립트나 이와 유사한 환경에서 ASF를 실행 중이시라면, ASF가 스스로 재시작하지 못하도록 이 스위치를 활용하는 것도 좋은 방법입니다.

---

--no-steam-parental-generation - 기본적으로 ASF는 SteamParentalCode 설정 속성에 설명된 대로 Steam 자녀 보호 PIN을 자동으로 생성하려고 시도합니다. 다만, 이 과정이 과도한 시스템 자원을 요구할 수 있으므로, 이 스위치를 사용하면 해당 동작을 비활성화할 수 있습니다. 이 경우 ASF는 자동 생성 과정을 건너뛰고 곧바로 사용자에게 PIN을 요청하는데, 이는 원래 자동 생성이 실패했을 때만 일어나는 동작입니다. 일반적으로는 이 자동 생성 기능을 활성화된 상태로 두는 것을 권장하지만, 특정한 이유로 이를 비활성화하고 ASF가 그렇게 하지 않기를 원하신다면 이 스위치를 사용하여 그 목적을 달성할 수 있습니다.

---

--path <path> 혹은 --path=<path> - ASF는 설치시에 자체 디렉토리를 탐색합니다. 이 인수를 지정하면 ASF는 초기화 후 지정된 디렉터리로 이동합니다. 이를 통해 config, logs, plugins, www 디렉터리 및 NLog.config 파일 등 애플리케이션의 다양한 구성 요소에 대해 사용자 지정 경로를 사용할 수 있으며, 실행 파일을 같은 위치에 중복으로 둘 필요가 없습니다. 리눅스형태의 패키징에서 그런 것 처럼 바이너리와 실제 환경설정을 분리하고자 할때 특히 유용합니다. 이 방식으로 여러 다른 설치본을 하나의 (최신) 바이너리만으로 사용할 수 있습니다. 경로는 ASF 바이너리의 현재 위치에서 상대경로 또는 절대경로로 지정할 수 있습니다. 이 명령은 새로운 "ASF 홈" 디렉터리를 가리킨다는 점을 유의하세요. 이는 원본 ASF와 동일한 구조를 가지며, 내부에 config 디렉터리를 포함합니다. 자세한 설명은 아래 예시를 참고하세요.

이 속성값의 특성때문에 ASF_PATH 환경 변수를 선언하여 예상 경로를 설정하는 것도 가능합니다. 프로세스 인자 중 민감한 정보를 피하고 싶은 사람들에게 더 적절합니다.

이 명령줄 인수를 사용해 여러 ASF 인스턴스를 실행하려고 하신다면, 관련 내용을 저희 **관리 페이지**에서 확인해 보시길 권장합니다.

예제:

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 (자동 생성됨)
│           ├── 📁 plugins (선택 사항)
│           ├── 📁 www (선택 사항)
│           ├── 📄 log.txt (자동 생성됨)
│           └── 📄 NLog.config (선택 사항)
└── ...

---

--service - 이 스위치는 주로 저희 systemd 서비스에서 사용되며 Headless 값을 true로 강제 설정합니다. 특별한 필요가 없다면, 대신 설정 파일에서 Headless 속성을 직접 구성하시는 것을 권장합니다. 이 스위치는 저희 systemd 서비스가 자체 환경에 맞추기 위해 전역 설정 파일을 건드릴 필요가 없도록 마련된 것입니다. 물론 비슷한 필요가 있으시다면 이 스위치를 활용하셔도 되지만, 그렇지 않다면 전역 설정 속성을 사용하시는 편이 더 낫습니다.

---

--system-required - ASF가 전체 생애주기동안 시스템이 살아있어야 한다는 신호를 운영체제에 보내도록 합니다. 밤 시간 동안 PC나 노트북에서 파밍할 때 특히 유용할 수 있습니다. ASF가 실행되는 동안 시스템이 절전 모드로 전환되지 않도록 유지할 수 있기 때문입니다. 이 기능은 현재 Linux와 Windows에서 지원됩니다.

Linux에서는 Inhibit() 함수를 지원하는 로그인 데몬과 함께 정상적으로 작동하는 dbus 가 필요합니다. 가장 널리 쓰이는 두 데몬인 systemd와 elogind가 이를 지원하는 것으로 확인되었습니다. ASF가 시작 후 절전 방지(inhibit) 잠금을 제대로 유지하고 있는지 확인하려면 systemd-inhibit --list 또는 elogind-inhibit --list 같은 명령어를 사용할 수 있습니다. 대부분의 데스크톱 환경(Gnome, KDE 등)은 이미 이 기능에 자체적으로 의존하고 있으므로 별도 설정 없이 바로 작동합니다. 다른 데스크톱 환경(DE)에서는 dbus가 아직 설치되어 있지 않을 경우 별도로 설치가 필요할 수 있습니다.

Windows에서는 별도 요구 사항 없이 바로 작동합니다.