구성 #

YAML 구성 파일에는 Nakama 서버가 실행되는 방식의 다양한 측면이 지정됩니다. 구성 파일을 지정하지 않고 Nakama를 실행할 수 있으며 대신 기본 설정이 사용됩니다.

구성 파일 지정 #

--config 플래그를 사용하여 런타임 시 구성 파일을 지정할 수 있습니다.

1

nakama --config my-special-config.yml

Docker-Compose를 통해 Nakama를 실행하는 경우 Docker에서 사용할 수 있도록 시스템의 폴더를 바인딩해야 합니다. Docker에서 실행되는 Nakama 구성 문서를 참조하세요.

서버 포트 #

Nakama는 매우 유연한 시스템입니다. gRPC, HTTP, Websockets 및 rUDP를 통해 서버와 데이터를 교환할 수 있습니다. 이러한 유연성으로 인해 Nakama는 다음에 바인딩할 때 4개의 포트를 사용할 수 있어야 합니다:

• 포트 7350의 HTTP API 서버. 포트는 구성에서 변경할 수 있습니다.
• 포트 7351에서 임베디드 개발자 콘솔에 전원을 공급하는 HTTP API 서버. 포트는 구성에서 변경할 수 있습니다.
• 포트 7349의 gRPC API 서버. 포트는 API 서버 포트를 기반으로 선택됩니다.
• 포트 7348의 내장 콘솔용 gRPC API 서버. 포트는 API 서버 포트를 기반으로 선택됩니다.

일반 속성 #

대부분의 환경에서 몇 가지 구성 속성을 변경해야 합니다. 예를 들어 실제 프로덕션 환경에 Nakama를 배포하기 전에 socket.server_key, session.encryption_key 및 **runtime.http_key**의 값을 변경해야 합니다. 전체 구성 목록은 페이지 하단에 있습니다.

서버 구성 #

Nakama는 다양한 사용 사례 및 배포 환경에 최대한 유연하게 사용할 수 있도록 구성 옵션을 다양하게 제공합니다.

Nakama는 모든 구성 옵션에 대해 적정한 기본값을 제공하므로 옵션의 일부만 재정의하면 됩니다. 또한 고유한 구성 파일을 설정하고 명령줄 플래그를 통해 구성 파일의 값을 재정의할 수 있습니다. 예를 들어 런타임 경로를 재정의하려면 다음을 수행합니다:

1

nakama --runtime.path /tmp/my-modules

필드가 구체적이지 않으면 기본값이 사용됩니다. 플래그를 재정의하는 방법에 대한 자세한 내용은 서버 명령줄 페이지를 참조하세요.

클러스터 #

이 섹션에서는 클러스터를 형성하기 위해 노드를 서로 연결하는 방법을 설명합니다.

콘솔 #

이 섹션에서는 임베디드 개발자 콘솔에 관련된 구성을 정의했습니다.

데이터베이스 #

Nakama를 사용하려면 CockroachDB 서버 인스턴스가 필요합니다. Nakama는 CockroachDB 데이터베이스 내에서 nakama(이)라는 자체 데이터베이스를 생성하고 관리합니다.

다음과 같은 명령을 사용하여 여러 데이터베이스 주소를 Nakama에 전달할 수 있습니다:

1

nakama --database.address "root@db1:26257" --database.address "root@db2:26257"

IAP (인앱 구매) #

Nakama는 다양한 상점에 연결하여 인앱 구매를 검증할 수 있으며 유효한 구매 원장을 보관합니다. 따라서 유효한 영수증을 통해 일반적인 인앱 구매 재생 공격이 방지되고 필요에 따라 사용자 계정에 대한 구매를 복원할 수 있습니다.

Apple #

Apple 인앱 구매 구성

Google #

Google 인앱 구매 구성

Huawei #

순위표 #

순위표 및 토너먼트 시스템 관련 구성 옵션을 변경할 수 있습니다.

로거 #

Nakama는 다양한 시스템이 로그와 상호 작용할 수 있도록 JSON 형식의 로그를 생성합니다. 기본적으로 로그는 표준 출력(콘솔)에 표시됩니다.

표준 시작 로그 메시지는 logger.stdout 필드 값에 관계없이 항상 콘솔에 표시됩니다.

대결 #

권한 부여 멀티플레이어 런타임 관련 구성 옵션을 변경할 수 있습니다.

메트릭스 #

Nakama는 메트릭스 정보를 생성합니다. 이 정보는 Prometheus로 내보낼 수 있습니다.

중요한 서버 정보가 포함되어 있으므로 메트릭스 내보내기가 보호되는지 확인합니다.

런타임 #

런타임 엔진 관련 옵션입니다.

런타임 환경은 키-값 쌍입니다. 다음과 같이 = 문자로 구분됩니다:

1

nakama --runtime.env "key=value" --runtime.env "key2=value2" --runtime.env "key3=valuecanhave=sign"

세션 #

토큰 생성에 사용된 암호화 키와 같이 각 사용자에 관련된 구성 옵션을 변경할 수 있습니다.

소셜 #

Nakama에서는 다양한 소셜 네트워크에 연결하여 사용자 정보를 가져올 수 있습니다. 또한 알림을 전달하고 유지하기 위한 알림 센터 역할도 가능합니다.

Apple #

Apple iOS/iPadOS 앱에 관련된 구성입니다.

Steam #

Steam 네트워크 설정을 구성합니다. Facebook, Google 및 GameCenter의 경우 서버 설정이 필요하지 않습니다.

Facebook 인스턴트 게임 #

Facebook 인스턴트 게임에 관련된 구성입니다.

소켓 #

서버와 클라이언트 간의 연결 소켓 및 전송 프로토콜에 관련된 옵션입니다.

추적기 #

세션 추적에 관련된 구성 옵션을 변경할 수 있습니다.

다음 구성 옵션은 Nakama 서버의 Nakama Enterprise 버전에서만 사용할 수 있습니다.

Nakama는 프로덕션 환경에서 고가용성 클러스터로 실행되도록 설계되었습니다. Nakama Enterprise를 실행 중인 경우 개발 머신에서 로컬로 클러스터를 시작할 수 있습니다. 프로덕션에서는 Nakama Enterprise 또는 Heroic Cloud 서비스를 사용할 수 있습니다.

매치 메이커 #

매치메이킹에 관련된 구성 옵션을 변경할 수 있습니다.

예제 파일 #

전체 파일을 사용하거나 구성의 일부만 사용할 수 있습니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

name: nakama-node-1
data_dir: "./data/"

logger:
  stdout: false
  level: "warn"
  file: "/tmp/path/to/logfile.log"
  rotation: false
  max_size: 100
  max_age: 0
  max_backups: 0
  local_time: false
  compress: false

metrics:
  reporting_freq_sec: 60
  namespace: ""
  prometheus_port: 7354

database:
  address:
    - "root@localhost:26257"
  conn_max_lifetime_ms: 0
  max_open_conns: 0
  max_idle_conns: 100

runtime:
  env:
    - "example_apikey=example_apivalue"
    - "encryptionkey=afefa==e332*u13=971mldq"
  path: "/tmp/modules/folders"
  http_key: "defaulthttpkey"

socket:
  server_key: "defaultkey"
  port: 7350
  max_message_size_bytes: 4096 # bytes
  read_timeout_ms: 10000
  write_timeout_ms: 10000
  idle_timeout_ms: 60000
  write_wait_ms: 5000
  pong_wait_ms: 10000
  ping_period_ms: 8000 # Must be less than pong_wait_ms
  outgoing_queue_size: 16

session:
  encryption_key: "defaultencryptionkey"
  token_expiry_sec: 60
    refresh_encryption_key: "defaultrefreshencryptionkey"
    refresh_token_expiry_sec: 3600

social:
  steam:
  publisher_key: ""
  app_id: 0

console:
  port: 7351
  username: "admin"
  password: "password"

cluster:
  join:
    - "10.0.0.2:7352"
    - "10.0.0.3:7352"
  gossip_bindaddr: "0.0.0.0"
  gossip_bindport: 7352
  rpc_port: 7353
  local_priority: true
  work_factor_interval_ms: 1000

tracker:
  max_delta_sizes:
    - 100
    - 1000
    - 10000

matchmaker:
  max_tickets: 2
  interval_sec: 15
  max_intervals: 3

iap:
  apple:
    shared_password: "password"
  google:
    client_email: "email@google.com"
    private_key: "pk"
  huawei:
    public_key: "pk"
    client_id: "id"
    client_secret: "secret"