---
title: "保存 HTTP 代理配置"
method: PUT
path: "/settings/http-proxy"
tags: ["设置"]
---

# 保存 HTTP 代理配置

`PUT /settings/http-proxy`

设置全局 HTTP 代理地址（如 http://192.168.1.1:7890）。设为空字符串则关闭代理。保存后即时生效，无需重启。

## Request body

- HandlersHttpProxySetting
  - `proxy` string

## Response `200`

保存后的代理配置

- HandlersHttpProxySetting
  - `proxy` 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/6781c074532c/schema)