From 5a5837e3082f50ca3b55d485bf6f6162f1c0511d Mon Sep 17 00:00:00 2001
From: Herald Yu <herald@juicedata.io>
Date: Fri, 28 Jan 2022 15:12:29 +0800
Subject: [PATCH] close #962 (#1354)

---
 docs/en/reference/how_to_setup_object_storage.md  | 15 +++++++++++++++
 .../reference/how_to_setup_object_storage.md      | 15 +++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/docs/en/reference/how_to_setup_object_storage.md b/docs/en/reference/how_to_setup_object_storage.md
index 169f26e1b09e..054264ec06a9 100644
--- a/docs/en/reference/how_to_setup_object_storage.md
+++ b/docs/en/reference/how_to_setup_object_storage.md
@@ -44,6 +44,21 @@ $ juicefs format --storage s3 \
 
 Public clouds typically allow users to create IAM (Identity and Access Management) roles, such as [AWS IAM role](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) or [Alibaba Cloud RAM role](https://www.alibabacloud.com/help/doc-detail/110376.htm), which can be assigned to VM instances. If the cloud server instance already has read and write access to the object storage, there is no need to specify `--access-key` and `--secret-key`.
 
+## Using Proxy
+
+If the network environment where the client is located is affected by firewall policies or other factors that require access to external object storage services through a proxy, the corresponding proxy settings are different for different operating systems, please refer to the corresponding user manual for settings.
+
+On Linux, for example, the proxy can be set by creating `http_proxy` and `https_proxy` environment variables.
+
+```shell
+$ export http_proxy=http://localhost:8035/
+$ export https_proxy=http://localhost:8035/
+$ juicefs format \
+    --storage s3 \
+    ... \
+    myjfs
+```
+
 ## Supported Object Storage
 
 If you wish to use a storage type that is not listed, feel free to submit a requirement [issue](https://github.com/juicedata/juicefs/issues).
diff --git a/docs/zh_cn/reference/how_to_setup_object_storage.md b/docs/zh_cn/reference/how_to_setup_object_storage.md
index cdc6b9e89340..b04db4776f99 100644
--- a/docs/zh_cn/reference/how_to_setup_object_storage.md
+++ b/docs/zh_cn/reference/how_to_setup_object_storage.md
@@ -44,6 +44,21 @@ $ juicefs format --storage s3 \
 
 公有云通常允许用户创建 IAM（Identity and Access Management）角色，例如：[AWS IAM 角色](https://docs.aws.amazon.com/zh_cn/IAM/latest/UserGuide/id_roles.html) 或 [阿里云 RAM 角色](https://help.aliyun.com/document_detail/93689.html)，可将角色分配给 VM 实例。如果云服务器实例已经拥有读写对象存储的权限，则无需再指定 `--access-key` 和 `--secret-key`。
 
+## 使用代理
+
+如果客户端所在的网络环境受防火墙策略或其他因素影响需要通过代理访问外部的对象存储服务，使用的操作系统不同，相应的代理设置方法也不同，请参考相应的用户手册进行设置。
+
+以 Linux 为例，可以通过创建 `http_proxy` 和 `https_proxy` 环境变量设置代理：
+
+```shell
+$ export http_proxy=http://localhost:8035/
+$ export https_proxy=http://localhost:8035/
+$ juicefs format \
+    --storage s3 \
+    ... \
+    myjfs
+```
+
 ## 支持的存储服务
 
 如果你希望使用的存储类型不在列表中，欢迎提交需求 [issue](https://github.com/juicedata/juicefs/issues)。