tencent cloud

다운로드 및 설치 설정
PDF 다운로드
마지막 업데이트 시간:2025-11-12 16:22:47
다운로드 및 설치 설정
마지막 업데이트 시간: 2025-11-12 16:22:47
PDF 다운로드
COSCLI 툴은 Windows, macOS, Linux 운영체제의 이진 패키지를 제공하므로 간단한 설치 및 구성 후 사용할 수 있다.

절차 1: COSCLI 툴 다운로드

비지니스 시나리오에 따라 COSCLI 툴 다운로드를 위한 주소를 선택할 수 있습니다. 귀하의 서버가 국내에 있는 경우 국내 사이트 다운로드 주소를 사용하는 것을 추천합니다(여기에 연결된 도구 버전은 모두 최신 버전입니다. 이전 버전을 사용하려면 release를 방문하여 기록된 버전을 가져올 수 있습니다).
국내 사이트 다운로드 주소
GitHub 다운로드 주소(해외 사이트를 추천)
SHA256 검사
77c26d2e0226e16c1affa0e0c220cec2f3fd256461d0679162223d54336e5038
3bebe5d4dc0b82a0bc4e4e266ee9223b50aae3dd8c66fe3b54c9f1f2d03b4c97
af76ceebe450d2c9656a221112ca0c64e6662545be7a6ad1a39ac888a978cd72
66b910ec6cc9d182c6b6625b3c6c7c9336fff1967198e5ca9b5581e6b6b8c0ac
Linux-386
Linux-386
78801347f02aa4fac820fa5684b41a256e5c25f8fe9ed2be7a3c7dce90f892a4
fc8d33b5b654b5a0d00c6f01019193c67c0855180b036cdb42cda18b735b736b
Linux-arm
Linux-arm
54a6ee193a19a35b57179bcb8e9bb977063e400b76ba25c7f073fba4574ce553
ca24967718c37e6961bf6167ea10b42b165d8a6fe3a7fa5f07225f0129461dbc
명령행을 통해 국내 사이트 macOS 및 Linux 환경에서의 COSCLI 툴 파일을 얻을 수 있습니다.
macOS-amd64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-amd64
macOS-arm64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-arm64
Linux-386:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-386
Linux-amd64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-amd64
Linux-arm:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-arm
Linux-arm64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-arm64
설명:
GitHub에서 현재 버전 번호가 v1.0.7이며, 툴의 최신 버전, 버전 히스토리 및 업데이트 로그가 필요하시면 release로 이동하여 확인하십시오.

절차 2: COSCLI 툴 설치

Windows

1. windows-amd64 버전을 예시로 설명합니다,다운로드된 Windows판 COSCLI 툴을 C:\\Users\\<사용자 이름> 디렉터리로 이동합니다.
2. coscli-windows.exe의 이름을 coscli.exe로 변경합니다.
3. win+r를 클릭하여 실행창을 엽니다.
4. 실행창에서 cmd을 입력하고, Enter를 클릭하여 명령행 창을 엽니다.
5. 명령 프롬프트에 다음 명령을 입력하세요.
coscli --version
coscli 버전 v1.0.7이 출력되면 설치가 성공한 것입니다.
설명:
Windows 시스템에서, 상이한 명령행 클라이언트에서 COSCLI를 사용하는 방식은 다소 차이가 있으며, coscli [command]를 입력한 후 COSCLI가 정상적으로 작동하지 않으면 ./coscli [command]의 포맷을 시도해 보세요.

macOS

1. macOS-amd64 버전을 예시로 설명합니다,아래 명령을 실행하여 macOS판 COSCLI 파일의 이름을 변경합니다.
mv coscli-darwin-amd64 coscli
2. 아래 명령을 실행하여 파일 실행 권한을 변경합니다.
chmod 755 coscli
3. 명령 프롬프트에 다음 명령을 입력하세요.
./coscli --version
coscli 버전 v1.0.7이 출력되면 설치가 성공한 것입니다.
설명:
macOS 시스템에서 COSCLI를 사용할 때 개발자 검증이 불가능하여 “coscli”을 열 수 없음이라는 알림이 뜨면 설정 > 보안성과 개인정보 보호 > 일반으로 이동하여 coscli 계속 열기를 선택하면 COSCLI를 정상적으로 사용할 수 있습니다.

Linux

1. Linux-amd64 버전을 예시로 설명합니다,아래 명령을 실행하여 Linux판 COSCLI 파일의 이름을 변경합니다.
mv coscli-linux-amd64 coscli
2. 아래 명령을 실행하여 파일 실행 권한을 변경합니다.
chmod 755 coscli
3. 명령 프롬프트에 다음 명령을 입력하세요.
./coscli --version
coscli 버전 v1.0.7이 출력되면 설치가 성공한 것입니다.

절차 3: COSCLI 툴 구성

주의:
사용자는 임시 키를 통해 툴을 사용하고 임시 인가를 통해 툴 사용의 안전성을 더욱 향상시킬 것이 좋습니다. 임시 키 신청 시, 최소 권한 안내 원칙에 따라 목표 버킷 또는 오브젝트 이외의 리소스 누설을 방지합니다.
반드시 영구 키를 사용하시려면 최소 권한 안내 원칙에 따라 영구 키의 권한 범위를 제한하시기 바랍니다.
COSCLI를 처음 사용할 때, 사용자는 구성 파일을 초기화해야 합니다. 구성 파일은 다음 2개 부분의 내용을 포함합니다.
COSCLI가 Tencent Cloud 계정에 접근할 수 있도록 인가하려면 키 ID, 키 Key, 임시 키 Token을 구성해야 합니다.
상용 버킷에 별칭을 추가하려면 상용 버킷 이름, 버킷 소재 리전 정보, 버킷 별칭을 구성해야 합니다. 상용 버킷 정보를 구성한 후, 사용자는 버킷 이름 및 리전 정보를 작성할 필요가 없이 별칭을 사용하여 버킷 작업을 수행할 수 있습니다. 다수의 상용 버킷을 구성한 후 버킷 간 또는 리전 간 작업을 더 간편하게 수행할 수 있습니다. 상용 버킷 정보를 구성할 필요가 없으면 Enter를 클릭하여 건너뛸 수 있습니다.
처음 사용할 때 COSCLI는 자동으로 ./coscli config init를 호출하여 ~/.cos.yaml 위치에서 구성 파일을 생성하므로 명령행에서 대화식으로 구성을 완성할 수 있습니다. 후속 ./coscli config init 명령을 사용하여 기타 위치에서 COSCLI를 위해 대화식으로 구성 파일을 생성할 수 있습니다. ./coscli config show를 사용하여 구성 파일의 위치 및 구성 매개변수 정보를 조회할 수 있습니다.
구성 파일 내 각 구성 항목에 대한 설명은 다음과 같습니다.
구성 항목
필수 여부
설명
Secret ID
예
키 ID, 서브 계정 키를 사용하고 최소 권한 안내에 따라 인가하여 사용 리스크를 줄이는 것이 좋습니다. 서브 계정 키 획득은 서브 계정 접근 키 관리를 참고하시기 바랍니다.
주의:
초기화 또는 명령으로 구성된 Secret ID는 암호화되어 저장됩니다. 구성 파일을 수동으로 수정하려면 Disable Encryption 매개변수를 설정하여 키 암호화를 해제해야 합니다.
Secret Key
예
키 Key, 서브 계정 키를 사용하고 최소 권한 안내에 따라 인가하여 사용 리스크를 줄이는 것이 좋습니다. 서브 계정 키 획득은 서브 계정 접근 키 관리를 참고하시기 바랍니다.
주의:
초기화 또는 명령으로 구성된 Secret Key는 암호화되어 저장됩니다. 구성 파일을 수동으로 수정하려면 Disable Encryption 매개변수를 설정하여 키 암호화를 해제해야 합니다.
Session Token
아니요
임시 키 token, 임시 키를 사용할 때 구성이 필요하며, 사용하지 않으면 직접 Enter를 클릭하여 건너뛸 수 있습니다. 임시 키에 관한 더 많은 정보는 임시 키를 사용하여 COS에 접근하기를 참고하시기 바랍니다.
주의:
초기화 또는 명령으로 구성된 Session Token는 암호화되어 저장됩니다. 구성 파일을 수동으로 수정하려면 Disable Encryption 매개변수를 설정하여 키 암호화를 해제해야 합니다.
Mode
아니요
아이덴티티 모드를 설정하고, 열거값 SecretKey 및 CvmRole을 지원합니다. 공백일 수 있고, 공백 값은 기본적으로 SecretKey이며, 키를 사용하여 COS를 요청함을 의미합니다. Mode가 CvmRole인 경우 인스턴스 역할 관리를 사용하여 COS를 요청함을 의미합니다.
Cvm Role Name
아니요
CVM 역할 인스턴스 이름을 설정하려면 인스턴스 역할 관리를 참고하시기 바랍니다.
protocol
아니요
네트워크 전송 프로토콜은 기본적으로 https입니다. http로 변경하시려면 직접 구성 파일에 들어가서 수정할 수 있다.
APPID
예
APPID는 Tencent Cloud 계정을 성공적으로 신청한 후 획득되는 계정으로서 시스템에 의해 자동으로 할당되며, 계정 정보에서 획득할 수 있다. 버킷의 전칭은 Bucket Name 및 APPID의 2개 요소로 구성되고 포맷은 <BucketName-APPID>이며, 자세한 내용은 버킷 명명 규범을 참고하시기 바랍니다.
Bucket Name
예
버킷 이름과 APPID가 함께 버킷 전칭을 구성하고 포맷은 <BucketName-APPID>이며, 자세한 내용은 버킷 명명 규범을 참고하시기 바랍니다.
Bucket Endpoint
예
버킷 소재 리전의 도메인 이름은 기본 도메인 이름 포맷이 cos.<region>.myqcloud.com이며, 여기서 <region>는 버킷 리전을 나타내며, 예를 들어 ap-guangzhou, ap-beijing 등이며, COS가 지원되는 리전 리스트는 리전과 접근 도메인을 참고하시기 바랍니다.
버킷이 글로벌 가속을 활성화한 경우 글로벌 가속 도메인 이름을 구성할 수 있습니다. 예를 들어, 글로벌 가속 도메인 이름을 cos.accelerate.myqcloud.com로 구성하고, 전용망 글로벌 가속 도메인 이름은 cos-internal.accelerate.tencentcos.cn로 구성합니다.
Bucket Alias
아니요
버킷 별칭, 구성 후 사용할 때 BucketAlias로 BucketName-APPID를 대체하여 입력해야 할 명령어 길이를 줄일 수 있으며, 이 항목을 구성하지 않는 경우 BucketAlias의 값은 BucketName-APPID의 값이다.
OFS Bucket
아니요
메타데이터 가속 버킷 태그, 해당 버킷의 메타데이터 가속 기능이 활성화되었는지 여부를 식별하기 위해 사용된다.
CloseAutoSwitchHost
아니요
백업 도메인 이름 자동 전환을 끌지 여부를 설정합니다. 옵션값 true | false는 비워둘 수 있습니다.
설정하지 않거나 값이 false인 경우 백업 도메인 이름이 전환됩니다.
true로 설정된 경우 백업 도메인 이름을 전환하지 않습니다.
DisableEncryption
아니요
키 암호화 여부 설정. 옵션값: true | false (빈 값 가능).
설정하지 않거나 false인 경우, 구성 파일의 키 정보가 암호화됩니다.
true로 설정하면 구성 파일의 키 정보가 암호화되지 않습니다.
DisableAutoFetchBucketType
아니요
자동 버킷 유형 획득 종료 여부 설정. 옵션값: true | false (빈 값 가능).
설정하지 않거나 값이 false인 경우, 도구는 자동으로 버킷 유형을 획득하며 cos:HeadBucket 권한이 필요합니다.
true로 설정한 경우, 도구는 자동으로 버킷 유형을 인식하지 않고 매개변수 --bucket-type을 기준으로 우선적으로 버킷 유형을 결정합니다. 해당 매개변수가 설정되지 않은 경우, 구성 파일의 버킷 정보에 있는 ofs 매개변수에 따라 버킷 유형을 결정합니다(true는 OFS 버킷, false는 COS 버킷을 의미함). 구성 파일에 버킷 정보가 포함되지 않은 경우, 기본적으로 COS 버킷 유형을 사용합니다.
처음 구성할 때 COSCLI는 하나의 버킷의 정보만 구성할 것을 요구하며, 다수의 버킷을 구성하시려면 후속 ./coscli config add 명령을 사용하여 버킷 구성을 추가할 수 있습니다. 구성 파일을 수정하거나 더 많은 관련 구성 파일에 대한 작업이 필요하시면 config 명령을 참고하거나 ./coscli config --help 명령을 사용하여 구성 파일과 관련된 명령어를 빠르게 조회할 수 있습니다.
명령어를 본격적으로 사용하기 전에 ./coscli --help 명령을 사용하여 COSCLI의 사용 방법을 빠르게 조회할 수 있습니다.

기타 구성 방법

./coscli config init를 사용하여 대화식으로 구성 파일을 생성하는 것 외에 COSCLI의 구성 파일을 직접 수동으로 작성할 수 있습니다. COSCLI의 구성 파일 포맷은 YAML 포맷이고, 구성 파일 예시는 다음과 같습니다.
cos:

  base:

    secretid: XXXXXXXXXXXXXXX

    secretkey: XXXXXXXXXXXXXXXXX

    sessiontoken: ""

    protocol: https

  buckets:

  - name: examplebucket1-1250000000

    alias: bucket1

    region: ap-shanghai

    endpoint: cos.ap-shanghai.myqcloud.com

    ofs: false

  - name: examplebucket2-1250000000

    alias: bucket2

    region: ap-guangzhou

    endpoint: cos.ap-guangzhou.myqcloud.com

    ofs: false

  - name: examplebucket3-1250000000

    alias: bucket3

    region: ap-chengdu

    endpoint: cos.ap-chengdu.myqcloud.com

    ofs: false
주의:
COSCLI는 기본적으로 ~/.cos.yaml로부터 구성 항목을 읽으며, 사용자가 사용자 정의된 구성 파일을 사용하시려면 명령 뒤에 -c （--config-path） 선택 항목을 사용하세요. 구성 파일에 저장된 secretid/secretkey/sessiontoken은 모두 암호화 후의 문자열입니다.
문제 해결에 도움이 되었나요?
더 자세한 내용은 문의하기 또는 티켓 제출 을 통해 문의할 수 있습니다.
예
아니오

피드백