linux宝塔面板使用API自动部署更新文件的完整指南

# self.api_key 是在接口配置获取的接口密钥
# 公众号: 小满小慢 
def _generate_sign(self) -> dict:
    now_time = int(time.time())
    api_key_md5 = hashlib.md5(self.api_key.encode()).hexdigest()
    token_str = str(now_time) + api_key_md5
    token = hashlib.md5(token_str.encode()).hexdigest()
    return {
        'request_token': token,
        'request_time': now_time
    }

# self.panel_url 配置的宝塔面板地址
# 公众号: 小满小慢
def _post(self, endpoint: str, data: dict = None) -> dict:
  if data is None:
      data = {}
  sign_params = self._generate_sign()
  all_data = {**data, **sign_params}
  url = urljoin(self.panel_url, endpoint)
  try:
      response = requests.post(
          url, 
          data=all_data, 
          timeout=self.request_timeout,
          verify=False
      )
      response.raise_for_status()
      result = response.json()
      if result.get('status') == False:
          raise Exception(f"地心侠士: API 错误: {result.get('msg', '未知错误')}")
      return result
  except requests.exceptions.RequestException as e:
      raise Exception(f"地心侠士: 请求失败: {e}")

# 公众号: 小满小慢
# 小游戏: 地心侠士
def upload_file(self, local_path: str, remote_path: str) -> bool:
  try:
      file_name = os.path.basename(local_path)
      file_size = os.path.getsize(local_path)
      remote_dir = os.path.dirname(remote_path)
      print(f"  地心侠士 准备上传: {file_name} ({file_size} bytes) -> {remote_path}")
      sign_data = self._generate_sign()
      data = {
          'f_path': remote_dir,
          'f_name': remote_path,
          'f_size': file_size,
          'f_start': 0,
          'request_token': sign_data['request_token'],
          'request_time': sign_data['request_time']
      }
      files = {
          'blob': (file_name, open(local_path, 'rb'), 'application/octet-stream')
      }
      endpoint = '/files?action=upload'
      url = urljoin(self.panel_url, endpoint)
      headers = {
          'Accept': '*/*',
          'Accept-Encoding': 'zh-CN,zh;q=0.9',
          'Connection': 'keep-alive'
      }
      response = requests.post(
          url, 
          headers=headers,
          data=data, 
          files=files,
          timeout=self.request_timeout,
          verify=False
      )
      files['blob'][1].close()
      response.raise_for_status()
      result = response.json()
      if result.get('status') == False:
          raise Exception(f"地心侠士 API 错误: {result.get('msg', '未知错误')}")
      print(f"  地心侠士 [成功] 文件上传完成: {file_name}")
      return True
  except Exception as e:
      print(f"  地心侠士 [错误] 文件上传失败: {e}")
      return False

# remote_zip 是服务上传的zip文件路径
# web_site_path 是网站解压路径
# 公众号: 小满小慢
 try:
    unzip_result = api._post('/files?action=UnZip', {
        'sfile': remote_zip,
        'dfile': web_site_path,
        'encoding': 'utf-8'
    })
    if unzip_result.get('status'):
        print(f"  地心侠士 [成功] ZIP文件已解压到: {web_site_path}")
        try:
            api._post('/files?action=DeleteFile', {
                'path': remote_zip
            })
            print(f"  地心侠士 [成功] 已清理临时ZIP文件")
        except:
            pass
    else:
        print(f"  地心侠士 [警告] 解压可能有问题: {unzip_result.get('msg', '未知错误')}")
        print(f"  地心侠士 请手动解压: {remote_zip} -> {web_site_path}")

# 公众号: 小满小慢
# 返回信息说明: name 网站名称 path 网站路径 site_id 网站ID
sites_result = api._post('/data?action=getData', {
  'table': 'sites',
  'limit': 1000
})

stop_result = api._post('/site?action=SiteStop', {
    'id': site_id,
    'name': site_name
})

start_result = api._post('/site?action=SiteStart', {
    'id': site_id,
    'name': site_name
})