---
title: "更新私网代理白名单"
method: PUT
path: "/settings/proxy-private-allowlist"
tags: ["资源代理"]
---

# 更新私网代理白名单

`PUT /settings/proxy-private-allowlist`

覆盖式更新私网代理白名单。每条须为单个 IP（IPv4/IPv6）或 CIDR 网段；空白条目自动忽略。任一条目非法返回 400。设置后，目标解析到的私网地址若被白名单覆盖，/proxy 即放行（用于「公网 Songloft 代理内网 WebDAV」等场景）。

## Request body

- HandlersProxyAllowlistSettingRequest
  - `allowlist` string[]

## Response `200`

返回更新后的白名单

- HandlersProxyAllowlistSettingRequest
  - `allowlist` string[]

## Other responses

- `400` — 请求格式错误或含非法条目
- `500` — 保存配置失败

---

[API](https://skmtc.net/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.net/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/versions/e4d4950ef665/schema)