企业官网建设流程全解析

在日常的开发的，存储文件我们一般会用到云存储，如阿里云，华为云等。云存储的 URL 可以直接在浏览器访问，因为对象存储 OSS 支持 HTTP 直连访问，只要权限允许，URL 就是一个公网资源地址。但是在开发中，如果我们想把文件存储在本地的服务器中，我们通常会有两种方法。1 使用二进制流访问文件信息，2 通过nginx代理访问信息。下面来演示这两种方法。

1.使用二进制流如何下载本地文件

典型场景：

前端传一个文件存储路径（本地磁盘）
后端用二进制流读取文件 → 返回给浏览器下载

一、Controller 下载接口（核心代码）

支持：本地文件路径 → 浏览器下载

@GetMapping("/download") public void download(@RequestParam("path") String filePath, HttpServletResponse response) { File file = new File(filePath); if (!file.exists()) { throw new RuntimeException("文件不存在：" + filePath); } response.setContentType("application/octet-stream"); response.setCharacterEncoding("utf-8"); // 文件名处理（防止中文乱码） String fileName = URLEncoder.encode(file.getName(), StandardCharsets.UTF_8) .replaceAll("\\+", "%20"); response.setHeader("Content-Disposition", "attachment;filename*=UTF-8''" + fileName); try (InputStream in = new BufferedInputStream(new FileInputStream(file)); OutputStream out = new BufferedOutputStream(response.getOutputStream())) { byte[] buffer = new byte[8192]; int len; while ((len = in.read(buffer)) != -1) { out.write(buffer, 0, len); } out.flush(); } catch (Exception e) { throw new RuntimeException("文件下载失败", e); } }

二、前端访问方式

浏览器直接访问：

http://localhost:8080/download?path=/data/files/test.pdf

就会自动下载文件。

2.使用ngnix代理访问本地存储文件

使用 Nginx 代理访问本地存储文件是生产环境里非常常见、性能也最好的方案（比 Java 流式下载更快、更省服务器资源）。

一、场景示意

假设：

服务器磁盘目录： /data/files/ ├── a.pdf ├── img.png └── report.docx

你希望访问：

http://your-domain/files/a.pdf

直接打开 / 下载文件。

二、Nginx 配置（核心）

编辑 nginx 配置文件：

vim /etc/nginx/nginx.conf

添加：

server { listen 80; server_name localhost; # 或你的域名 / IP location /files/ { alias /data/files/; # ⚠️ 必须以 / 结尾 autoindex off; # 关闭目录浏览（安全） # 下载文件（强制下载） add_header Content-Disposition attachment; # 允许大文件 client_max_body_size 1024m; } }

关键说明（非常重要）

location /files/访问路径前缀

alias /data/files/ 映射到磁盘目录

三、重载 Nginx

nginx -t # 检查配置是否正确 nginx -s reload

四、访问测试

浏览器访问：

http://localhost/files/a.pdf

如果能下载，说明配置成功 ✅