Golang跨计算机快速文件传输工具Portal使用指南

Portal是一个用Go语言编写的跨计算机快速文件传输工具，它允许你在不同计算机之间快速传输文件和目录。下面我将详细介绍Portal的安装和使用方法，并提供Go代码示例。

安装Portal

首先，你需要安装Portal工具：

go install github.com/SpatiumPortae/portal@latest

或者从GitHub下载预编译的二进制文件：

# Linux
wget https://github.com/SpatiumPortae/portal/releases/download/v1.0.0/portal_1.0.0_linux_amd64.tar.gz
tar -xzf portal_1.0.0_linux_amd64.tar.gz
sudo mv portal /usr/local/bin/

# macOS
wget https://github.com/SpatiumPortae/portal/releases/download/v1.0.0/portal_1.0.0_darwin_amd64.tar.gz
tar -xzf portal_1.0.0_darwin_amd64.tar.gz
sudo mv portal /usr/local/bin/

基本使用方法

发送文件

在发送端计算机上运行：

portal send /path/to/file

这将生成一个一次性密码，接收方需要使用这个密码来接收文件。

接收文件

在接收端计算机上运行：

portal receive <password>

接收方需要与发送方在同一局域网内，或者发送方需要配置端口转发。

高级功能

发送整个目录

portal send -r /path/to/directory

指定自定义端口

portal send -p 8080 /path/to/file
portal receive -p 8080 <password>

压缩传输

portal send -z /path/to/large/file

Go代码示例

如果你想在自己的Go程序中集成类似功能，可以参考以下代码示例：

package main

import (
	"fmt"
	"net"
	"os"
	"path/filepath"
)

func sendFile(conn net.Conn, filePath string) error {
	// 打开文件
	file, err := os.Open(filePath)
	if err != nil {
		return err
	}
	defer file.Close()

	// 获取文件信息
	fileInfo, err := file.Stat()
	if err != nil {
		return err
	}

	// 发送文件名和大小
	fileName := filepath.Base(filePath)
	fileSize := fileInfo.Size()
	fmt.Fprintf(conn, "%s\n%d\n", fileName, fileSize)

	// 发送文件内容
	buf := make([]byte, 1024)
	for {
		n, err := file.Read(buf)
		if err != nil {
			break
		}
		conn.Write(buf[:n])
	}

	return nil
}

func receiveFile(conn net.Conn, savePath string) error {
	// 读取文件名和大小
	var fileName string
	var fileSize int64
	fmt.Fscanf(conn, "%s\n%d\n", &fileName, &fileSize)

	// 创建文件
	file, err := os.Create(filepath.Join(savePath, fileName))
	if err != nil {
		return err
	}
	defer file.Close()

	// 接收文件内容
	var received int64
	buf := make([]byte, 1024)
	for received < fileSize {
		n, err := conn.Read(buf)
		if err != nil {
			return err
		}
		file.Write(buf[:n])
		received += int64(n)
	}

	return nil
}

安全注意事项

1. Portal传输默认不加密，敏感文件建议先加密再传输
2. 一次性密码只能使用一次，传输完成后即失效
3. 在公共网络使用时，建议配合VPN或SSH隧道

性能优化

对于大文件传输，可以考虑以下优化：

1. 使用-z选项启用压缩
2. 增加缓冲区大小
3. 使用多线程传输（Portal暂不支持，但可以自行实现）

常见问题解决

1. 连接失败：检查防火墙设置，确保端口（默认8080）开放
2. 传输速度慢：检查网络状况，尝试使用有线连接
3. 文件损坏：验证文件哈希值，或重新传输

Portal是一个简单高效的文件传输工具，特别适合在局域网内快速共享文件。对于更复杂的需求，可以考虑使用rsync或scp等工具。

希望这个指南对你有所帮助！如果你需要更复杂的功能，可以考虑基于上面的Go代码示例进行扩展开发。