服务启动 → 读取 /etc/<服务>/config.yml（默认值，不建议改）
         → 按字母序扫描 /etc/<服务>/conf.d/*.yml
         → 第一个匹配键的文件生效，后续同名键被忽略

/etc/wazo-agentd/conf.d/
├── .01-critical.yml      ← 被忽略（点开头）
├── 02-error.yml.dpkg-old ← 被忽略（不是 .yml 结尾）
├── 10-debug.yml          ← 生效：log_level: debug
└── 20-nodebug.yml        ← log_level 被忽略（10-debug.yml 已先设定）

cat /etc/wazo-auth/config.yml

cat <<'EOF' > /etc/wazo-auth/conf.d/90-oauth2.yml
# 启用 OAuth2 SSO（可选，对接企业 AD / Google / GitHub）
oauth2:
  # 允许的外部提供者，可用自定义
  providers:
    google:
      client_id: "your-google-client-id.apps.googleusercontent.com"
      client_secret: "your-google-client-secret"
      authorize_url: "https://accounts.google.com/o/oauth2/auth"
      token_url: "https://oauth2.googleapis.com/token"
      userinfo_url: "https://www.googleapis.com/oauth2/v3/userinfo"
EOF
systemctl restart wazo-auth

cat /etc/wazo-confd/config.yml | head -40

# 示例：给 confd 增加超时保护
cat <<'EOF' > /etc/wazo-confd/conf.d/90-timeout.yml
http:
  timeout: 30
  cors:
    enabled: true
    origins:
      - "https://my-wazo-web.example.com"
EOF
systemctl restart wazo-confd

cat /etc/wazo-confgend/config.yml | head -30

# 第一步：在 wazo-confgend 配置里声明要启用的模块
cat <<'EOF' > /etc/wazo-confgend/conf.d/enable-res_cli_aliases.yml
enabled_asterisk_modules:
  res_cli_aliases.so: true
EOF

# 第二步：重启 confgend 让配置生效
systemctl restart wazo-confgend

# 第三步：用 wazo-confgen 手动触发一次生成（也可等下次 Asterisk 重启）
wazo-confgen asterisk/modules.conf | grep res_cli_aliases
# load => yes          ← 模块已标记为启用

# 第四步：重启 Asterisk
systemctl restart asterisk

asterisk -rx "module show like res_cli_aliases"
# Module                         Description                              Use Count  Status
# res_cli_aliases.so             Asterisk CLI Aliases                     0          Running

# 默认配置
cat /etc/wazo-websocketd/config.yml

/etc/asterisk/
├── asterisk.conf          ← 不要自定义（wazo-confgend 生成）
├── modules.conf           ← 不要自定义（wazo-confgend 生成 + 自动覆盖）
├── pjsip.conf             ← 不要自定义（wazo-confgend 生成）
├── extensions.conf        ← 不要自定义（wazo-confgend 生成）
├── queues.conf            ← 不要自定义（wazo-confgend 生成）
├── features.conf          ← 不要自定义
├── manager.conf           ← 只改 manager.d/
├── music-on-hold.conf     ← 可直接改
│
├── manager.d/              ← ✅ Asterisk 管理器接口自定义用户放这里
│   └── my_new_user.conf
├── pjsip.d/                ← ✅ PJSIP 端点自定义覆盖
├── extensions_extra.d/     ← ✅ 自定义 dialplan 片段（加载在默认 extensions.conf 之后）
│   └── transfer-dtmf.conf
├── queues.d/               ← ✅ 队列自定义覆盖
├── voip-info.d/            ← ✅ SIP header 自定义
├── ...（更多 *.d/ 子目录）

cat <<'EOF' > /etc/asterisk/manager.d/my_monitor.conf
[my_monitor]
secret = v3ry5ecre7
deny=0.0.0.0/0.0.0.0
permit=127.0.0.1/255.255.255.0
read = system,call,log,verbose,agent,user,config,dtmf,reporting,cdr,dialplan
write = originate,command
EOF
systemctl restart asterisk

cat <<'EOF' > /etc/asterisk/pjsip.d/90-corporate-nat.conf
# 全局 NAT 策略（企业内网场景）
[general]
externaddr = 203.0.113.10        # 公网 SIP trunk 接入地址
localnet = 10.0.0.0/8            # 内网地址段（NAT 后面的设备）
EOF
systemctl restart asterisk

cat <<'EOF' > /etc/asterisk/extensions_extra.d/transfer-dtmf.conf
[allow-transfer]
exten = s,1,NoOp(## Setting transfer context ##)
same = n,Set(TRANSFER_CONTEXT=my-transfer-context)
same = n,Return()
EOF
asterisk -rx "dialplan reload"

# 1. 用 wazo-confgend 声明
cat <<'EOF' > /etc/wazo-confgend/conf.d/enable-res_cli_aliases.yml
enabled_asterisk_modules:
  res_cli_aliases.so: true
EOF

# 2. 重启 confgend
systemctl restart wazo-confgend

# 3. 手动生成 modules.conf 确认
wazo-confgen asterisk/modules.conf | grep -A2 res_cli_aliases
# [res_cli_aliases]
# autoload => yes    ← ✅ 已启用

# 4. 重启 Asterisk
systemctl restart asterisk

# 5. 验证
asterisk -rx "module show like res_cli_aliases"
# ...  Status: Running

/etc/nginx/sites-available/wazo.conf
/etc/nginx/sites-enabled/wazo.conf   ← 符号链接

cat /etc/nginx/sites-enabled/wazo.conf | head -60

# 不要直接改 wazo.conf，新建一个 overlay
cat <<'EOF' > /etc/nginx/sites-available/wazo-custom
server {
    listen 80;
    server_name _;
    # 强制 HTTPS
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name _;

    # 证书（换成你的正式证书路径）
    ssl_certificate /etc/ssl/certs/wazo-server-cert.pem;
    ssl_certificate_key /etc/ssl/private/wazo-server-key.pem;

    # WebSocket 代理调优（给 websocketd 用）
    location /ws/ {
        proxy_pass http://localhost:9502/ws/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 3600s;   # WebSocket 长时间保持
        proxy_send_timeout 3600s;
    }

    # confd REST API
    location /api/confd/ {
        proxy_pass http://localhost:9486/api/confd/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_read_timeout 120s;
    }
}
EOF

# 启用自定义配置（注意：这会替换 Wazo 默认 wazo.conf）
rm -f /etc/nginx/sites-enabled/wazo.conf
ln -s /etc/nginx/sites-available/wazo-custom /etc/nginx/sites-enabled/wazo.conf

# 测试语法
nginx -t
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful

# 重载
nginx -s reload

cat /etc/xivo-dao/config.yml

db_uri: "postgresql://wazo:wazo@localhost/wazo"
db_port: 5432
pool_size: 5
pool_recycle: 3600

cat <<'EOF' > /etc/xivo-dao/conf.d/10-pool-size.yml
pool_size: 20
pool_recycle: 1800
EOF
# 需重启所有用到 xivo-dao 的服务
wazo-service restart

cat <<'EOF' > /etc/postgresql/16/main/conf.d/wazo-tuning.conf
# PostgreSQL 调优（16GB RAM 服务器）
shared_buffers = 4GB                    # RAM 的 25%
effective_cache_size = 12GB             # RAM 的 75%
work_mem = 64MB                         # 排序/哈希中间操作
maintenance_work_mem = 1GB              # VACUUM / CREATE INDEX
max_connections = 200                   # 足够 Wazo 各服务 + 备份
EOF

systemctl restart postgresql

sudo -u postgres psql -c "SHOW shared_buffers;"
# shared_buffers | 4GB

# 查看已加载的 PJSIP 端点
asterisk -rx "pjsip list endpoints"

# 查看某个 endpoint 的详细配置
asterisk -rx "pjsip show endpoint <endpoint_id>"

# 查看 dialplan 生效情况
asterisk -rx "dialplan show context default"

# 查看已加载模块
asterisk -rx "module show"