LayFz's Blog

蓝绿部署：零停机时间发布的最佳实践

Fri, 07 Mar 2025 16:37:00 GMT

蓝绿部署实践 🚀

📌 问题背景

在传统的Next.js项目部署中，我们经常会遇到以下问题：

🔴 部署过程中用户访问出现样式加载失败
🔴 静态资源无法正确加载
🔴 Next.js的后台任务被意外中断
🔴 用户体验断层，刷新页面出现短暂服务不可用

这些问题主要是因为在常规部署流程中，我们通常会直接在运行的服务上进行代码更新和重启，导致服务临时不可用。

💡 蓝绿部署解决方案

蓝绿部署(Blue-Green Deployment)是一种零停机部署策略，通过准备两套相同的生产环境，在不影响用户体验的情况下完成系统升级。

🔄 方案原理

准备两个完全相同的Next.js服务环境：
- 🔵 蓝环境：端口3019
- 🟢 绿环境：端口5019
使用宝塔面板的Nginx配置管理流量分发
- 在任一时刻，只有一个环境接收真实用户流量
- 另一个环境作为待命状态，用于准备新版本部署

🔄 具体实施流程

假设当前蓝环境(3019端口)正在提供服务：

准备绿环境 📦
- 将最新代码同步到绿环境(5019端口)目录
- 在绿环境执行构建过程：
```
npm install
npm run build
```
- 此时用户依然访问的是蓝环境(3019端口)，不受影响
启动绿环境服务 ▶️
- 使用PM2启动或重启绿环境服务：
```
pm2 restart next-app-green
```
- 确认绿环境服务正常运行

切换流量 🔀

修改Nginx配置，将用户流量从蓝环境切换到绿环境：

# 原配置
upstream nextjs_upstream {
    server 127.0.0.1:3019;
}

# 新配置
upstream nextjs_upstream {
    server 127.0.0.1:5019;
}

重载Nginx配置：
```
nginx -s reload
```

验证与回滚机制 ✅
- 验证绿环境(5019端口)是否正常提供服务
- 如发现问题，可立即切换回蓝环境(3019端口)

✨ 核心优势

这种蓝绿部署方案具有以下显著优势：

零停机时间 ⏱️：用户在整个部署过程中不会感知到服务中断
保持任务连续性 🔄：不活跃的环境不会被关闭，其中运行的任务和进程继续执行
快速回滚能力 ⏪：如果新版本出现问题，只需修改Nginx配置即可立即回滚
资源利用率高 📈：两个环境可以轮流部署，充分利用服务器资源

🛠️ 宝塔Nginx配置示例

server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        proxy_pass http://nextjs_upstream;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

upstream nextjs_upstream {
    server 127.0.0.1:5019; # 当前活跃环境
    # server 127.0.0.1:3019; # 注释掉非活跃环境
}

📊 部署流程示意

🔵 3019运行中 → 用户访问3019 → 代码同步到5019 → 5019构建完成
                                                    ↓
🔄 流量切换 ← Nginx配置修改 ← 5019服务启动 ← 5019构建验证
                                                    ↓
🟢 5019运行中 → 用户无感知迁移 → 3019保持运行但无流量

🎯 总结

通过蓝绿部署策略，我们成功解决了Next.js项目在传统部署方式下面临的问题。这种方案不仅保证了用户体验的连续性，还为后端任务提供了稳定的运行环境。

在实际应用中，这种部署模式特别适合以下场景：

🚀 高流量Next.js应用
⏱️ 包含重要后台任务的Next.js项目
👨‍💻 对用户体验和服务连续性要求较高的应用

通过宝塔面板和Nginx的配合，这种部署策略的实施变得简单高效，大大提升了Next.js应用的可靠性和用户满意度。

Cocos 接入穿山甲广告 SDK

Tue, 06 Aug 2024 00:00:00 GMT

Cocos 接入穿山甲广告 SDK

在这个教程中，我将详细介绍如何在 Cocos 引擎中接入穿山甲广告 SDK。我们将分步介绍如何在 Cocos 项目中集成穿山甲Android SDK，包括环境配置、代码实现和测试等内容。

前提条件

在开始之前，请确保你具备以下条件：

已安装 Cocos Creator 或 Cocos2d-x。
已创建一个 Cocos 项目。

注意事项：

由于Android平台更新迭代非常快，开发者很容易陷入版本冲突以及兼容问题，若要使用该教程，请使用推荐的的版本配置：
- Gradle：8.0.2
- Gradle Plugin：8.0.2
- Android NDK: 21.3.6528147
- Android SDK: 29
- Cocos Creator: 2.4.13

获取穿山甲 SDK

访问穿山甲官网：前往穿山甲并登录你的账户。
下载 SDK：在开发者中心找到Android SDK，下载并解压缩。

集成 SDK

1. 集成 Android SDK

导入 SDK 文件：
- 将下载的 Android SDK 文件（.aar 或 .jar 文件）放入 Cocos 项目的 assets 目录下的 Plugins/Android 文件夹中。

配置 Gradle 文件：

打开 Cocos 项目的 proj.android-studio/app/build.gradle 文件。
在 dependencies 部分添加穿山甲 SDK 的依赖：

implementation 'com.android.support:appcompat-v7:28.0.0'
//融合基础包，必须引入
implementation "com.pangle.cn:mediation-sdk:6.2.1.7"
implementation "com.alibaba:fastjson:1.2.83"

更新 AndroidManifest.xml：

在 proj.android-studio/app/src/main/AndroidManifest.xml 中添加穿山甲所需的权限和服务： xml <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>  <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> application部分： ```xml

    <activity
        android:name="org.cocos2dx.javascript.AppActivity"
        android:screenOrientation="portrait"
        android:configChanges="orientation|keyboardHidden|screenSize|screenLayout|uiMode"
        android:label="@string/app_name"
        android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
        android:launchMode="singleTask"
        android:exported="true">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />

            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
    <!-- 穿山甲 start================== -->
    <provider
        android:name="com.bytedance.sdk.openadsdk.TTFileProvider"
        android:authorities="${applicationId}.TTFileProvider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>

    <provider
        android:name="com.bytedance.sdk.openadsdk.multipro.TTMultiProvider"
        android:authorities="${applicationId}.TTMultiProvider"
        android:exported="false" />
    <!-- 穿山甲 end================== -->
  </application>
  ```

4.添加xml文件：在res目录下添加文件file_paths.xml

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path name="tt_external_root" path="." />
    <external-path name="tt_external_download" path="Download" />
    <external-files-path name="tt_external_files_download" path="Download" />
    <files-path name="tt_internal_file_download" path="Download" />
    <cache-path name="tt_internal_cache_download" path="Download" />
</paths>

创建广告处理类 结构如下,创建并放到任意包下：

Const.java：

public class Const {
  public static String TAG = "TTSdkComponent";
}

TTAdManagerHolder.java：

public class TTAdManagerHolder {

  // 公共方法，封装了对私有方法的调用
  public void initialize(Context context, String appId) {
      initMediationAdSdk(context, appId);
      // 可以添加其他初始化逻辑或检查
  }

  //初始化聚合sdk
  private void initMediationAdSdk(Context context, String appId) {
      TTAdSdk.init(context, buildConfig(context, appId));
      TTAdSdk.start(new TTAdSdk.Callback() {
          @Override
          public void success() {
              System.out.println("初始化成功1");
              //初始化成功
              //在初始化成功回调之后进行广告加载"
//                JsbBridge.sendToScript("onInit", "true");
              // 一定要在 GL 线程中执行
              runOnGLThread(new Runnable() {
                  @Override
                  public void run() {
                      Cocos2dxJavascriptJavaBridge.evalString("Ad.onNative(\"onInit\", \"true\")");
                  }
              });
          }

          @Override
          public void fail(int i, String s) {
              //初始化失败
              System.out.println("初始化失败");
//                JsbBridge.sendToScript("onInit", "false");
              // 一定要在 GL 线程中执行
              runOnGLThread(new Runnable() {
                  @Override
                  public void run() {
                      Cocos2dxJavascriptJavaBridge.evalString("Ad.onNative(\"onInit\", \"false\")");
                  }
              });
          }
      });
  }

  private static TTAdConfig buildConfig(Context context, String appId) {

      return new TTAdConfig.Builder()
              /**
               * 注：需要替换成在媒体平台申请的appID ，切勿直接复制
               */
              .appId(appId)
              .appName("APP测试媒体")
              /**
               * 上线前需要关闭debug开关，否则会影响性能
               */
              .debug(false)
              /**
               * 使用聚合功能此开关必须设置为true，默认为false
               */
              .useMediation(true)
//                .customController(getTTCustomController()) //如果您需要设置隐私策略请参考该api
//                .setMediationConfig(new MediationConfig.Builder() //可设置聚合特有参数详细设置请参考该api
//                        .setMediationConfigUserInfoForSegment(getUserInfoForSegment())//如果您需要配置流量分组信息请参考该api
//                        .build())
              .build();
  }
}

TTSdkBannerAd.java:

public class TTSdkBannerAd {
  TTAdNative adNativeLoader;
  AdSlot adSlot;
  TTNativeExpressAd mBannerAd;
  FrameLayout mBannerContainer;
  Activity activity;
  float left, top;

  public TTSdkBannerAd(Activity activity, String codeId, float left, float top, int width, int height) {
      activity = activity;
      this.left = left;
      this.top = top;
      adNativeLoader = TTAdSdk.getAdManager().createAdNative(activity);
      adSlot = new AdSlot.Builder()
              .setCodeId(codeId)
              .setImageAcceptedSize(width, height) // 单位px
              .build();
      mBannerContainer = (FrameLayout) activity.findViewById(android.R.id.content).getRootView();
  }

  private void loadBannerExpressAd() {
      adNativeLoader.loadBannerExpressAd(adSlot, new TTAdNative.NativeExpressAdListener() {
          @Override
          public void onError(int i, String s) {
              Log.d(Const.TAG, "banner load fail: errCode: " + i + ", errMsg: " + s);
          }

          @Override
          public void onNativeExpressAdLoad(List<TTNativeExpressAd> list) {
              if (list != null && list.size() > 0) {
                  Log.d(Const.TAG, "banner load success");
                  destroyBannerAd();
                  mBannerAd = list.get(0);
                  mBannerAd.setSlideIntervalTime(30 * 1000);
                  if (mBannerAd != null) {
                      showBannerAd();
                  }
              } else {
                  Log.d(Const.TAG, "banner load success, but list is null");
              }
          }
      });
  }

  public void showBannerAd() {
      if (mBannerAd != null) {
          mBannerAd.setExpressInteractionListener(new
                    TTNativeExpressAd.ExpressAdInteractionListener() {
                        @Override
                        public void onAdClicked(View view, int i) {
                            Log.d(Const.TAG, "banner clicked");
                        }

                        @Override
                        public void onAdShow(View view, int i) {
                            Log.d(Const.TAG, "banner showed");
                        }

                        @Override
                        public void onRenderFail(View view, String s, int i) {
                            Log.d(Const.TAG, "banner renderFail, errCode" + i + ", errMsg: " + s);
                        }

                        @Override
                        public void onRenderSuccess(View view, float v, float v1) {
                            Log.d(Const.TAG, "banner render success");
                        }
                    });
          mBannerAd.setDislikeCallback(activity, new
                  TTAdDislike.DislikeInteractionCallback() {
                      @Override
                      public void onShow() {
                      }

                      @Override
                      public void onSelected(int i, String s, boolean b) {
                          Log.d(Const.TAG, "banner closed");
                          destroyBannerAd();
                      }

                      @Override
                      public void onCancel() {
                      }
                  });
          View bannerView = mBannerAd.getExpressAdView();
          if (bannerView != null && mBannerContainer != null) {
              mBannerContainer.addView(bannerView);
              bannerView.setX(left);
              bannerView.setY(top);
          }
      } else {
//            Log.d(Const.TAG, "请先加载广告或等待广告加载完毕后再展示广告");
          loadBannerExpressAd();
      }
  }

  public void destroyBannerAd() {
      if (mBannerAd != null) {
          mBannerAd.destroy();
          mBannerAd = null;
      }
  }
}

TTSdkComponent.java:

public class TTSdkComponent {

    TTSdkBannerAd mTTBannerAd = null;
    TTSdkRewardedVideoAd mTTRewardedVideoAd = null;
    TTSdkFullScreenVideoAd mTTSdkFullScreenVideoAd = null;
    TTSdkSplashAd mTTSdkSplashAd = null;

    Activity activity;
    
    public static TTSdkComponent mTTSdkComponent;


    public TTSdkComponent(Activity activity) {
        this.activity = activity;
        TTSdkComponent.mTTSdkComponent = this;
    }

    public static void  sendToNative(String arg0, String arg1){
        Log.d(Const.TAG, "banner load success, but list is null" + arg0 +"?" +arg1);
        TTSdkComponent.mTTSdkComponent.onScript(arg0,arg1);
    }

    public  void onScript(String arg0, String arg1){
        JSONObject jsonObject = JSON.parseObject(arg1);
        Activity activity = this.activity;
        if (arg0.equals("showToast")) {
            String content = jsonObject.getString("content");
            activity.runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    Toast.makeText(activity, content,
                            Toast.LENGTH_SHORT).show();
                }
            });
        } else if (arg0.equals("init")) {
            TTAdManagerHolder ttAdManagerHolder = new TTAdManagerHolder();
            String appId = jsonObject.getString("appId");
            ttAdManagerHolder.initialize(activity, appId);
        } else if (arg0.equals("showBannerAd")) {
            if (mTTBannerAd == null) {
                String codeId = jsonObject.getString("codeId");
                float left = jsonObject.getFloatValue("left");
                float top = jsonObject.getFloatValue("top");
                int width = jsonObject.getIntValue("width");
                int height = jsonObject.getIntValue("height");
                mTTBannerAd = new TTSdkBannerAd(activity, codeId, left, top, width, height);
            }
            if (mTTBannerAd != null) {
                boolean isShow = jsonObject.getBooleanValue("isShow");
                if (isShow) {
                    mTTBannerAd.showBannerAd();
                } else {
                    mTTBannerAd.destroyBannerAd();
                }
            }
        } else if (arg0.equals("showRewardVideoAd")) {
            if (mTTRewardedVideoAd == null) {
                String codeId = jsonObject.getString("codeId");
                mTTRewardedVideoAd = new TTSdkRewardedVideoAd(activity, codeId);
            }
            if (mTTRewardedVideoAd != null) {
                mTTRewardedVideoAd.showRewardVideoAd();
            }
        } else if (arg0.equals("showSplashAd")) {
            if (mTTSdkSplashAd == null) {
                String codeId = jsonObject.getString("codeId");
                int width = jsonObject.getIntValue("width");
                int height = jsonObject.getIntValue("height");
                mTTSdkSplashAd = new TTSdkSplashAd(activity, codeId, width, height);
            }
            mTTSdkSplashAd.showSplashAd(null);
        } else if (arg0.equals("showFullScreenVideoAd")) {
            if (mTTSdkFullScreenVideoAd == null) {
                String codeId = jsonObject.getString("codeId");
                mTTSdkFullScreenVideoAd = new TTSdkFullScreenVideoAd(activity, codeId);
            }
            mTTSdkFullScreenVideoAd.showFullScreenVideoAd();
        }
    }
}

TTSdkFullScreenVideoAd.java:

public class TTSdkFullScreenVideoAd {

    TTAdNative adNativeLoader;
    AdSlot adSlot;
    TTFullScreenVideoAd mTTFullScreenVideoAd;
    Activity activity;

    public TTSdkFullScreenVideoAd(Activity activity, String codeId) {
        this.activity = activity;
        adNativeLoader = TTAdSdk.getAdManager().createAdNative(activity);
        adSlot = new AdSlot.Builder()
                .setCodeId(codeId)
                .setOrientation(TTAdConstant.ORIENTATION_VERTICAL)//设置横竖屏方向
//                .setMediationAdSlot(new MediationAdSlot.Builder()
//                        .setMuted(true)//是否静音
//                        .setVolume(0.7f)//设置音量
//                        .setBidNotify(true)//竞价结果通知
//                        .build())
                .build();
    }

    public void loadFullScreenVideoAd(boolean isShow) {
        adNativeLoader.loadFullScreenVideoAd(adSlot, new TTAdNative.FullScreenVideoAdListener() {
            public void onError(int code, String message) {
                Log.d(Const.TAG, "InterstitialFull onError code = " + code + " msg = " + message);
            }

            public void onFullScreenVideoAdLoad(TTFullScreenVideoAd ad) {
                Log.d(Const.TAG, "InterstitialFull onFullScreenVideoLoaded");
                mTTFullScreenVideoAd = ad;
//                Log.d("sada",""+isShow);
                if (isShow) {
                    showFullScreenVideoAd();
                }
            }

            public void onFullScreenVideoCached() {
                Log.d(Const.TAG, "InterstitialFull onFullScreenVideoCached");
                Log.d("5785785727","57587575875");
            }

            public void onFullScreenVideoCached(TTFullScreenVideoAd ad) {
                Log.d("sasasdasd","sadasda");
                Log.d(Const.TAG, "InterstitialFull onFullScreenVideoCached");
                mTTFullScreenVideoAd = ad;
                if (isShow) {
                    showFullScreenVideoAd();
                }
            }
        });
    }

    public void showFullScreenVideoAd() {
//        Log.d("mm", ""+(mTTFullScreenVideoAd==null));
        if (mTTFullScreenVideoAd == null) {
            loadFullScreenVideoAd(true);
            return;
        }
        // 展示广告
        this.mTTFullScreenVideoAd.setFullScreenVideoAdInteractionListener(new TTFullScreenVideoAd.FullScreenVideoAdInteractionListener() {
            public void onAdShow() {
                Log.d(Const.TAG, "InterstitialFull onAdShow");
            }

            public void onAdVideoBarClick() {
                Log.d(Const.TAG, "InterstitialFull onAdVideoBarClick");
            }

            public void onAdClose() {
                Log.d(Const.TAG, "InterstitialFull onAdClose");
            }

            public void onVideoComplete() {
                Log.d(Const.TAG, "InterstitialFull onVideoComplete");
            }

            public void onSkippedVideo() {
                Log.d(Const.TAG, "InterstitialFull onSkippedVideo");
            }
        });
        this.mTTFullScreenVideoAd.showFullScreenVideoAd(activity);
        this.mTTFullScreenVideoAd = null;
    }
}

TTSdkRewardedVideoAd.java:

public class TTSdkRewardedVideoAd {
    TTAdNative adNativeLoader;
    AdSlot adSlot;
    TTRewardVideoAd mTTRewardVideoAd;
    Activity activity;
    public boolean mIsRewardValid;

    public TTSdkRewardedVideoAd(Activity activity, String codeId) {
        activity = activity;
        adNativeLoader = TTAdSdk.getAdManager().createAdNative(activity);
        adSlot = new AdSlot.Builder()
                .setCodeId(codeId)
                .setOrientation(TTAdConstant.VERTICAL)//横竖屏设置
//                .setMediationAdSlot(new MediationAdSlot
//                        .Builder()
//                        .setExtraObject(MediationConstant.ADN_PANGLE, "pangleRewardCustomData")//服务端奖励验证透传参数
//                        .setExtraObject(MediationConstant.ADN_GDT, "gdtRewardCustomData")
//                        .setExtraObject(MediationConstant.ADN_BAIDU, "baiduRewardCustomData")
//                        .build())
                .build();
    }

    private void loadRewardVideoAd(boolean isShow) {
        adNativeLoader.loadRewardVideoAd(adSlot, new TTAdNative.RewardVideoAdListener() {
            @Override
            public void onError(int i, String s) {
            }

            @Override
            public void onRewardVideoAdLoad(TTRewardVideoAd ttRewardVideoAd) {
                mTTRewardVideoAd = ttRewardVideoAd;
                if (isShow) {
                    showRewardVideoAd();
                }
            }

            @Override
            public void onRewardVideoCached() {

            }

            @Override
            public void onRewardVideoCached(TTRewardVideoAd ttRewardVideoAd) {
                mTTRewardVideoAd = ttRewardVideoAd;
                if (isShow) {
                    showRewardVideoAd();
                }
            }
        });
    }

    public void showRewardVideoAd() {
        mIsRewardValid = false;
        if (mTTRewardVideoAd == null) {
            loadRewardVideoAd(true);
            return;
        }
        mTTRewardVideoAd.setRewardAdInteractionListener(new TTRewardVideoAd.RewardAdInteractionListener() {
            @Override
            public void onAdShow() {
            }

            @Override
            public void onAdVideoBarClick() {
            }

            @Override
            public void onAdClose() {
//                JsbBridge.sendToScript("onRewardAdCallback", mIsRewardValid ? "true" : "false");
                // 一定要在 GL 线程中执行
                runOnGLThread(new Runnable() {
                    @Override
                    public void run() {
                        String success = mIsRewardValid ? "true" : "false";
                        Cocos2dxJavascriptJavaBridge.evalString("Ad.onNative(\"onRewardAdCallback\", \""+success+"\")");
                    }
                });
            }

            @Override
            public void onVideoComplete() {
            }

            @Override
            public void onVideoError() {
            }

            @Override
            //已废弃，请使用onRewardArrived方法
            public void onRewardVerify(boolean rewardVerify, int rewardAmount, String rewardName, int errorCode, String errorMsg) {
            }

            @Override
            public void onRewardArrived(boolean isRewardValid, int rewardType, Bundle extraInfo) {//奖励是否发放请依据isRewardValid
                // 当用户的观看行为满足了奖励条件
                mIsRewardValid = isRewardValid;
            }

            @Override
            public void onSkippedVideo() {
            }
        });
        mTTRewardVideoAd.showRewardVideoAd(activity);
        mTTRewardVideoAd = null;
    }
}

TTSdkSplashAd.java:

public class TTSdkSplashAd {

    TTAdNative adNativeLoader;
    AdSlot adSlot;
    Activity activity;
    FrameLayout mSplashContainer;
    CSJSplashAd mCsjSplashAd;

    public TTSdkSplashAd(Activity activity, String codeId, int width, int height) {
        activity = activity;
        adNativeLoader = TTAdSdk.getAdManager().createAdNative(activity);
        adSlot = new AdSlot.Builder()
                .setCodeId(codeId)
                .setImageAcceptedSize(width, height)//单位px
                .build();
        mSplashContainer = (FrameLayout) activity.findViewById(android.R.id.content).getRootView();
    }

    public void loadSplashAd(boolean isShow) {
        adNativeLoader.loadSplashAd(adSlot, new TTAdNative.CSJSplashAdListener() {
            @Override
            public void onSplashRenderSuccess(CSJSplashAd csjSplashAd) {
                Log.d("SplashAd","onSplashRenderSuccess");
                /** 渲染成功后，展示广告 */
                if (isShow)
                    showSplashAd(csjSplashAd);
            }


            @Override
            public void onSplashLoadSuccess(CSJSplashAd csjSplashAd) {
                Log.d("SplashAd","onSplashLoadSuccess");
            }

            @Override
            public void onSplashLoadFail(CSJAdError csjAdError) {
                Log.d("SplashAd","onSplashLoadFail:"+csjAdError.getMsg());
            }

            @Override
            public void onSplashRenderFail(CSJSplashAd csjSplashAd, CSJAdError csjAdError) {
                Log.d("SplashAd","onSplashRenderFail:"+csjAdError.getMsg());
            }
        }, 3500);
    }

    public void showSplashAd(CSJSplashAd csjSplashAd) {
        if (csjSplashAd == null) {
            loadSplashAd(true);
            return;
        }
        csjSplashAd.setSplashAdListener(new CSJSplashAd.SplashAdListener() {
            @Override
            public void onSplashAdShow(CSJSplashAd csjSplashAd) {
            }

            @Override
            public void onSplashAdClick(CSJSplashAd csjSplashAd) {
            }

            @Override
            public void onSplashAdClose(CSJSplashAd csjSplashAd, int i) {
                // 广告关闭后，销毁广告页面
                finish();
            }
        });
        mCsjSplashAd = csjSplashAd;
        View splashView = csjSplashAd.getSplashView();
//        UIUtils.removeFromParent(splashView);
//        mSplashContainer.removeAllViews();
        mSplashContainer.addView(splashView);
    }

    public void finish() {
        if (mCsjSplashAd != null && mCsjSplashAd.getMediationManager() != null) {
            mSplashContainer.removeView(mCsjSplashAd.getSplashView());
            mCsjSplashAd.getMediationManager().destroy();
            mCsjSplashAd = null;
        }
    }
}

初始化组件 在AppActivity初始化组件

public class AppActivity extends Cocos2dxActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      // DO OTHER INITIALIZATION BELOW
      SDKWrapper.getInstance().init(this);
      // 初始化组件
      new TTSdkComponent(this);
  }
}

至此安卓的初始化就完成了，穿山甲不愧是大平台，接入就是如此丝滑

配置穿山甲广告

1. 初始化 SDK

在 Cocos 项目的主脚本中，初始化穿山甲 SDK：首先创建如下TS脚本,如果采用js请自行转换。 Ad.ts:

const { ccclass, property } = cc._decorator;
 
@ccclass("AdConfigBase")
class AdConfigBase {
    @property({ displayName: "广告Id" })
    codeId: string = "";
};
 
@ccclass("RewardedVideoAdConfig")
class RewardedVideoAdConfig extends AdConfigBase {
};
 
@ccclass("BannerAdConfig")
class BannerAdConfig extends AdConfigBase {
    @property({ displayName: "宽度" })
    width: number = 500;
    @property({ displayName: "高度" })
    height: number = 300;
};
 
@ccclass("InterstitialAdConfig")
class InterstitialAdConfig extends AdConfigBase {
};
 
@ccclass("SplashAdConfig")
class SplashAdConfig extends AdConfigBase {
};
 
@ccclass("Ad")
export class Ad {
    @property({ displayName: "应用appId" })
    appId: string = "";
    @property({ type: BannerAdConfig, displayName: "Banner广告" })
    bannerAdConfig: BannerAdConfig = new BannerAdConfig();
    @property({ type: RewardedVideoAdConfig, displayName: "激励视频广告" })
    rewardedVideoAdConfig: RewardedVideoAdConfig = new RewardedVideoAdConfig();
    @property({ type: SplashAdConfig, displayName: "开屏广告" })
    splashAdConfig: SplashAdConfig = new SplashAdConfig();
    @property({ type: InterstitialAdConfig, displayName: "插屏广告" })
    interstitialAdConfig: InterstitialAdConfig = new InterstitialAdConfig();
 
    private rewardAdCallback: any;
    private rewardAdCallbackObj: any;
 
    private static onNativeCallback: any;
    private static onNativeCallbackObj: any;
 
    sendToNative(arg0: string, arg1?: string) {
        // native.bridge.sendToNative(arg0, arg1);
        jsb.reflection.callStaticMethod("com/yiyuancoder/ttsdk/TTSdkComponent", "sendToNative", "(Ljava/lang/String;Ljava/lang/String;)V", arg0, arg1);
    }
 
    public static onNative(arg0: string, arg1: string) {
        if (this.onNativeCallback != null) {
            this.onNativeCallback.call(this.onNativeCallbackObj, arg0, arg1);
            this.onNativeCallback = null;
            this.onNativeCallbackObj = null;
        }
    }
 
    async init() {
        return new Promise((resolve, reject) => {
            // native.bridge.onNative = (arg0: string, arg1: string): void => {
            //     if (arg0 == 'onInit') {
            //         resolve(arg1 == "true");
            //     }
            // }
            Ad.onNativeCallbackObj = this;
            Ad.onNativeCallback = (arg0: string, arg1: string) => {
                if (arg0 == 'onInit') {
                    resolve(arg1 == "true");
                }
            }
            this.sendToNative("init", JSON.stringify({ appId: this.appId }));
        })
    }
 
    /**
    * 显示Banner广告
    */
    showBannerAd(show: boolean): void {
 
        let width = this.bannerAdConfig.width;
        let height = this.bannerAdConfig.height;
        let left = screen.width / 2 - width / 2;
        let top = screen.height - height;
        this.sendToNative("showBannerAd", JSON.stringify({ isShow: show, codeId: this.bannerAdConfig.codeId, left: left, top: top, width: width, height: height }));
    }
 
    /**
     * 播放激励视频广告
     */
    showRewardedVideoAd(rewardAdCallback: Function, rewardAdCallbackObj: any): void {
        this.rewardAdCallback = rewardAdCallback;
        this.rewardAdCallbackObj = rewardAdCallbackObj;
 
        let that = this;
        // native.bridge.onNative = (arg0: string, arg1: string): void => {
        //     if (arg0 == 'onRewardAdCallback') {
        //         that.onRewardAdCallback(arg1 == "true");
        //     }
        // }
        Ad.onNativeCallbackObj = this;
        Ad.onNativeCallback = (arg0: string, arg1: string) => {
            if (arg0 == 'onRewardAdCallback') {
                that.onRewardAdCallback(arg1 == "true");
            }
        }
        this.sendToNative("showRewardVideoAd", JSON.stringify({ codeId: this.rewardedVideoAdConfig.codeId }));
    }
 
    /**
     * 激励视频广告回调
     */
    onRewardAdCallback(success: boolean) {
        if (this.rewardAdCallback) {
            this.rewardAdCallback.call(this.rewardAdCallbackObj, success);
            this.rewardAdCallback = null;
            this.rewardAdCallbackObj = null;
        }
    }
 
    /**
     * 显示开屏广告
     */
    showSplashAd(): void {
        this.sendToNative("showSplashAd", JSON.stringify({ codeId: this.splashAdConfig.codeId, width: screen.width, height: screen.height }));
    }
 
    /**
     * 显示插屏广告
     */
    showFullScreenVideoAd() {
        // 在适合的场景显示插屏广告
        this.sendToNative("showFullScreenVideoAd", JSON.stringify({ codeId: this.interstitialAdConfig.codeId }));
    }
};
 
window.Ad = Ad;

TTSdkComponent.ts:

import { Ad } from "./Ad";
 
const { ccclass, property } = cc._decorator;
 
declare var wx: any;
 
@ccclass
export default class TTSdkComponent extends cc.Component {
 
    @property({ type: Ad, displayName: "广告模块" })
    ad: Ad = new Ad();
 
    sendToNative(arg0: string, arg1?: string) {
        jsb.reflection.callStaticMethod("com/yiyuancoder/ttsdk/TTSdkComponent", "sendToNative", "(Ljava/lang/String;Ljava/lang/String;)V", arg0, arg1);
    }
 
    showToast(content: string) {
        this.sendToNative('showToast', JSON.stringify({ content: content }));
    }
}

Main.ts:

//获取穿山甲Sdk组件
let ttSdkComponent = cc.find("TTSdkComponent").getComponent(TTSdkComponent);
//初始化
let inited = await ttSdkComponent.ad.init();
console.log(inited);
if (!inited) {
        ttSdkComponent.showToast("广告组件初始化失败");
        return;
}

以上Main.ts文件主要用于初始化脚本。

2. 挂载脚本

在你的cocos场景中新建节点，并挂载脚本文件：如上，填上你在平台申请的信息。

3. 调用广告

import TTSdkComponent from "./TTSdkComponent";
const { ccclass, property } = cc._decorator;


async start(){
  // banner
  ttSdkComponent.ad.showBannerAd(bannerAdFlag);
  // reward
  ttSdkComponent.ad.showRewardedVideoAd((success: boolean) => {
      ttSdkComponent.showToast(success ? "恭喜获得奖励" : "完整观看视频才能获得奖励哦");
  }, this);
  // 开屏
  ttSdkComponent.ad.showSplashAd();
  //插屏
  ttSdkComponent.ad.showFullScreenVideoAd();
}

以上仅为示例代码，在你的具体业务中请一定要初始化以后再调用方法。

至此你就可以接入穿山甲实现广告变现

Cocos接入九游 SDK

Tue, 27 Aug 2024 17:23:47 GMT

Android接入九游 SDK

本文档提供了如何在 Android 项目中接入九游 SDK 的详细步骤。九游 SDK 是一个为游戏开发者提供各种功能的工具包，如广告、分析、用户认证等。

准备工作

创建九游账号:
- 访问九游开发者平台注册并登录账户。
下载九游 SDK:
- 登录开发者平台，下载最新版本的九游 SDK。以上是SDK9.7.8.0_7.7.1.0版本的sdk文件夹。我们需要的是demo包，具体路径在这个位置👇
准备应用信息:
- 获取你的应用包名、应用密钥等必要的信息，这些信息在九游开发者平台上会提供。
- 主要是获取gameId,这是需要初始化的

集成 SDK

1. 将九游 SDK 添加到项目中

添加 SDK 依赖:
- 将九游 SDK 的 .aar 文件添加到项目的 aar 目录下。如果没有 aar 目录，可以手动创建一个。

配置 Gradle:

在 app 模块的 build.gradle 文件中，添加对九游 SDK 的依赖：

dependencies {
   implementation fileTree(dir: 'aar', include: ['*.jar','*.aar'])
}

2. 修改 AndroidManifest.xml

添加权限和服务:

打开 AndroidManifest.xml 文件，添加九游 SDK 所需的权限和服务：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.SEND_SMS" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.AUTHENTICATE_ACCOUNTS" />
<uses-permission android:name="android.permission.USE_CREDENTIALS" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.READ_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_CALENDAR" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
<uses-permission android:name="android.permission.MANAGE_ACCOUNTS" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

以上是权限部分，依次添加activity部分：

 <!-- android:taskAffinity 填上游戏的包名，如游戏包名为cn.uc.gamesdk.demo，则下面填 cn.uc.gamesdk.demo.diff -->
   <!-- data android:scheme 里填上”ng+当前游戏的gameId”,如游戏ID是123456,则填上ng123456 -->
   <activity
       tools:replace="android:taskAffinity"
       android:name="cn.uc.gamesdk.activity.PullupActivity"
       android:theme="@android:style/Theme.Translucent"
       android:taskAffinity="com.example.app.diff"
       android:excludeFromRecents="true"
       android:label="PullupActivity"
       android:launchMode="singleTop"
       android:exported="true"
       tools:node="replace">
       <intent-filter>
           <action android:name="android.intent.action.VIEW"/>
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE"/>
           <data android:scheme="ng132465" />
       </intent-filter>
   </activity>

   <activity
       android:name="cn.gundam.sdk.shell.activity.ThemeProxyActivity"
       android:configChanges="keyboardHidden|orientation|screenSize"
       android:label="@string/app_name"
       android:theme="@android:style/Theme.NoTitleBar"
       android:windowSoftInputMode="adjustResize" >
       <intent-filter>
           <action android:name="cn.uc.gamesdk.sdkweb" />

           <category android:name="android.intent.category.DEFAULT" />
       </intent-filter>
   </activity>

   <!-- sdk service  1.1.3新增 -->
   <service
       android:name="cn.gundam.sdk.shell.service.ProxyService"
       android:process=":bgservice"
       android:exported="false"
       tools:replace="android:exported"/>
   <!-- sdk service end-->

   <!-- 以上声明是SDK内部声明，最好不要更改，直接拷贝过去 -->

处理 Manifest 合并冲突:
- 如果在集成过程中出现 Manifest 合并冲突，可以通过 tools:replace 来解决。例如：
```
<application
    android:allowBackup="true"
    tools:replace="android:allowBackup">
    
</application>
```
- 确保在 AndroidManifest.xml 文件的开头添加了 xmlns:tools="http://schemas.android.com/tools" 以支持 tools 命名空间。以上部分添加到位，基本就完成了引入，附几张图注意要修改的部分：

3. 初始化九游 SDK

在 AppActivity 类中初始化:

在你的 AppActivity 类中初始化九游 SDK：

 import cn.gundam.sdk.shell.even.SDKEventKey;
 import cn.gundam.sdk.shell.even.SDKEventReceiver;
 import cn.gundam.sdk.shell.even.Subscribe;
 import cn.gundam.sdk.shell.exception.AliLackActivityException;
 import cn.gundam.sdk.shell.open.ParamInfo;
 import cn.gundam.sdk.shell.open.UCOrientation;
 import cn.gundam.sdk.shell.param.SDKParamKey;
 import cn.gundam.sdk.shell.param.SDKParams;
 import cn.uc.gamesdk.UCGameSdk;

 public class AppActivity extends Cocos2dxActivity {
     @Override
     protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       // DO OTHER INITIALIZATION BELOW
       SDKWrapper.getInstance().init(this);
       UCGameSdk.defaultSdk().registerSDKEventReceiver(receiver);


       ucSdkInit();
     }
 }
  private void ucSdkInit() {
   ParamInfo gameParamInfo = new ParamInfo();

   gameParamInfo.setGameId(YOUR_GAME_ID);
   gameParamInfo.setOrientation(UCOrientation.PORTRAIT);

   SDKParams sdkParams = new SDKParams();
   sdkParams.put(SDKParamKey.GAME_PARAMS, gameParamInfo);
   // 如果游戏已经申请了权限，不想sdk主动请求权限，要通过SDKParamKey.GAME_HAD_REQUEST_PERMISSION参数告知九游sdk
   // true 游戏已经弹了，SDK不需要弹出权限申请窗
   // false 游戏没有弹，SDK可以按需弹出权限申请窗
   sdkParams.put(SDKParamKey.GAME_HAD_REQUEST_PERMISSION, false);


   try {
       //初始化SDK
       UCGameSdk.defaultSdk().initSdk(this, sdkParams);
   } catch (AliLackActivityException e) {
       e.printStackTrace();
   }
 }

 /**
  * 退出游戏前，请调用本方法
 * @param view
 */
 public void exit(View  view) {

     try {
         UCGameSdk.defaultSdk().exit(this, null);
     } catch (Exception e) {
         e.printStackTrace();
         exitApp();
     }
 }

 private void exitApp() {
     finish();
     //退出程序
     Intent intent = new Intent(Intent.ACTION_MAIN);
     intent.addCategory(Intent.CATEGORY_HOME);
     intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
     startActivity(intent);
     android.os.Process.killProcess(android.os.Process.myPid());
 }



 /**
  *回调事件
 */
 private SDKEventReceiver receiver = new SDKEventReceiver() {

     @Subscribe(event = SDKEventKey.ON_EXIT_SUCC)
     private void onExit(String desc) {
         Log.d(TAG, "ON_EXIT_SUCC");
         //Toast.makeText(MainActivity.this, ">> 游戏即将退出", Toast.LENGTH_LONG).show();

         exitApp();
     }

     @Subscribe(event = SDKEventKey.ON_EXIT_CANCELED)
     private void onExitCanceled(String desc) {
         runOnUiThread(new Runnable() {

             @Override
             public void run() {
                 //Toast.makeText(MainActivity.this, ">> 继续游戏", Toast.LENGTH_LONG).show();
             }
         });
     }

   //        @Subscribe(event = SDKEventKey.ON_LOGIN_SUCC)
   //        private void onLoginSucc(final String sid) {
   //            runOnUiThread(new Runnable() {
   //
   //                @Override
   //                public void run() {
   //                    if (TextUtils.isEmpty(sid)) {
   //                        // 离线试玩
   //                        Toast.makeText(AppActivity.this, ">> 离线登录成功", Toast.LENGTH_LONG).show();
   //                    } else {
   //                        // 用户登录
   //                        Toast.makeText(AppActivity.this, ">> 用户登录成功", Toast.LENGTH_LONG).show();
   //                    }
   //                }
   //            });
   //
   //        }

   //        @Subscribe(event = SDKEventKey.ON_LOGIN_FAILED)
   //        private void onLoginFailed(String desc) {
   //            runOnUiThread(new Runnable() {
   //
   //                @Override
   //                public void run() {
   //                    Toast.makeText(AppActivity.this, ">> 登录失败", Toast.LENGTH_LONG).show();
   //                }
   //            });
   //        }

           @Subscribe(event = SDKEventKey.ON_INIT_SUCC)
           private void onInitSucc() {
               runOnUiThread(new Runnable() {

                   @Override
                   public void run() {
   //                    Toast.makeText(AppActivity.this, ">> 初始化成功", Toast.LENGTH_LONG).show();
                   }
               });
           }

           @Subscribe(event = SDKEventKey.ON_INIT_FAILED)
           private void onInitFailed(String msg) {
               runOnUiThread(new Runnable() {

                   @Override
                   public void run() {
   //                    Toast.makeText(AppActivity.this, ">> 初始化失败", Toast.LENGTH_LONG).show();
                   }
               });
           }

   //        @Subscribe(event = SDKEventKey.ON_CREATE_ORDER_SUCC)
   //        private void onPaySucc(final Bundle data) {
   //            runOnUiThread(new Runnable() {
   //
   //                @Override
   //                public void run() {
   //                    Toast.makeText(MainActivity.this, ">> 支付成功", Toast.LENGTH_LONG).show();
   //                    Log.d(TAG, "此处为支付成功回调: callback data = " + data.getString("response"));
   //                }
   //            });
   //            String response = data.getString("response");
   //            // 这里执行发货，如果发货成功需要设置以下值
   //            data.putString("result", Response.OPERATE_SUCCESS_MSG);
   //            // 如果发货失败需要设置以下值
   //            //data.putString("result", Response.OPERATE_FAIL_MSG);
   //            Log.d(TAG, "pay succ" + data);
   //        }
   //
   //        @Subscribe(event = SDKEventKey.ON_PAY_USER_EXIT)
   //        private void onPayFail(String data) {
   //            runOnUiThread( new Runnable() {
   //
   //                @Override
   //                public void run() {
   //                    Toast.makeText(MainActivity.this, ">> 支付失败", Toast.LENGTH_LONG).show();
   //                }
   //            });
   //            Log.d(TAG, "pay exit");
   //        }

           // SDK侧发起的账号切换请求
           // 步骤1，侦听SDK切换账号指令
   //        @Subscribe(event = SDKEventKey.ON_ACCOUNT_SWITCH_REQUEST)
   //        private void onAccountSwitchRequest(final String sid) {
   //            Toast.makeText(MainActivity.this, "侦听到ON_ACCOUNT_SWITCH_REQUEST指令", Toast.LENGTH_SHORT).show();
   //            //步骤2，CP接入组先退出当前游戏角色
   //            logoutGameRole();
   //            //步骤3，和正常登录一样，调用sdk做登录请求
   //            //这里需要注意：
   //            //   1. 如果游戏的退出和重新登录在native层是异步的，
   //            //      那requestLogin()应该由cp自行决定在合适的节点调用，
   //            //      不要求必须放在onAccountSwitchRequest()方法中；
   //            //   2. requestLogin()只需要保证在角色已退出的情况下调用即可；
   //            login();
   //        }

 };

注意将代码中的 YOUR_GAME_ID 替换为从九游开发者平台获取的实际值。

配置项目

配置 ProGuard:

如果你的项目使用 ProGuard 混淆代码，确保在 proguard-rules.pro 文件中添加以下规则以防止混淆：

-dontwarn
-ignorewarnings
#-------------------------   联运 start ---------------------------------

-dontskipnonpubliclibraryclassmembers
-keepattributes Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,LocalVariable*Table,*Annotation*,Synthetic,EnclosingMethod

-keep public class * extends cn.gundam.sdk.shell.even.SDKEventReceiver

-keep class android.**{
    <methods>;
    <fields>;
}
-keep class cn.uc.**{
    <methods>;
    <fields>;
}
-keep class cn.gundam.**{
    <methods>;
    <fields>;
}

#-------------------------   联运 end ---------------------------------

测试和调试

运行应用:
- 启动你的应用并验证九游 SDK 是否正常工作。检查 SDK 的日志输出以确认初始化是否成功。
查看日志:
- 使用 Logcat 查看九游 SDK 的调试信息，确保没有出现错误或警告。
进行功能测试:
- 测试九游 SDK 提供的各种功能（如广告展示、用户登录等），确保它们在应用中正常工作。

常见问题

Manifest 合并冲突:
- 如果遇到 Manifest 合并冲突，请参阅处理 Manifest 合并冲突文档以获取更多信息。
SDK 初始化失败:
- 确保应用 ID 和密钥正确无误，并且网络连接正常。
日志查看:
- 使用 Logcat 查看 SDK 的调试信息，帮助排查问题。

参考资料

Cocos接入优量汇

Thu, 08 Aug 2024 10:55:28 GMT

Cocos 接入优量汇广告 SDK

在这个教程中，我将详细介绍如何在 Cocos 引擎中接入优量汇广告 SDK。优量汇是一款强大的广告平台，为开发者提供了丰富的广告资源和优质的广告体验。我们将分步介绍如何在 Cocos 项目中集成优量汇 SDK，包括环境配置、代码实现和测试等内容。

本教程使用的是腾讯聚合平台,聚合平台在2024-06-05作出修订，将不再维护聚合SDK

前提条件

在开始之前，请确保你具备以下条件：

已安装 Cocos Creator 或 Cocos2d-x。
已创建一个 Cocos 项目。

注意事项：

由于Android平台更新迭代非常快，开发者很容易陷入版本冲突以及兼容问题，若要使用该教程，请使用推荐的的版本配置：
- Gradle：8.0.2
- Gradle Plugin：8.0.2
- Android NDK: 21.3.6528147
- Android SDK: 29
- Cocos Creator: 2.4.13

获取优量汇 SDK

访问优量汇官网：前往优量汇并登录你的账户。
下载 SDK：在开发者中心找到Android SDK，下载并解压缩。聚合SDK已不提供下载，请联系作者获取，若有备份，忽略此条消息

集成 SDK

1. 集成 Android SDK

导入 SDK 文件：
- 将下载的 Android SDK 文件（.aar 或 .jar 文件）放入 Cocos 项目的 assets 目录下的 Plugins/Android 文件夹中。
配置 Gradle 文件：
- 打开 Cocos 项目的 proj.android-studio/app/build.gradle 文件。
- 在 dependencies 部分添加优量汇 SDK 的依赖：
```
implementation files('libs/your_sdk_file.aar')
```

更新 AndroidManifest.xml：

在 proj.android-studio/app/src/main/AndroidManifest.xml 中添加优量汇所需的权限和服务：

 <!--相关权限声明 : SDK不强制校验下列权限（即:无下面权限sdk也可正常工作），但建议开发者申请下面权限，尤其是READ_PHONE_STATE权限-->
 <!--READ_PHONE_STATE权限用于允许SDK获取用户标识,针对单媒体的用户，允许获取权限的，投放定向广告；不允许获取权限的用户，投放通投广告，媒体可以选择是否把用户标识数据提供给优量汇，并承担相应广告填充和eCPM单价下降损失的结果。-->
 <uses-permission android:name="android.permission.READ_PHONE_STATE" />
 <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

 <!-- 高于Android 7的系统上，如果应用的 targetSdkVersion >= 26 ，推荐增加权限声明（SDK将通过此权限触发App安装动作）-->
 <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

 <!-- 高于Android 11的系统上，如果应用的 targetSdkVersion >= 30 ，推荐增加以下权限声明（SDK将通过此权限正常触发广告行为，并保证广告的正确投放。此权限需要在用户隐私文档中声明。）-->
 <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
     tools:ignore="QueryAllPackagesPermission" />

 <!--检测当前⽹络状态是2G、3G、4G还是WiFi-->
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 <!--联⽹权限-->
 <uses-permission android:name="android.permission.INTERNET" />
 <!--读写存储权限-->
 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 <!--获取MAC地址，⽤于标识⽤户-->
 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
 <!--定位权限，不强制要求-->
 <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

application部分：

   <application
     android:name="org.cocos2dx.javascript.GDT.GDTApplication"
     android:allowBackup="true"
     android:label="@string/app_name"
     android:usesCleartextTraffic="true"
     tools:replace="android:allowBackup"
     android:icon="@mipmap/ic_launcher">
     <!-- Tell Cocos2dxActivity the name of our .so -->
     <meta-data android:name="android.app.lib_name"
         android:value="cocos2djs" />

     <activity
         android:name="org.cocos2dx.javascript.AppActivity"
         android:screenOrientation="portrait"
         android:configChanges="orientation|keyboardHidden|screenSize|screenLayout|uiMode"
         android:label="@string/app_name"
         android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
         android:launchMode="singleTask"
         android:exported="true">
         <intent-filter>
             <action android:name="android.intent.action.MAIN" />

             <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
     </activity>

     <activity
         android:name="org.cocos2dx.javascript.GDT.SplashActivity"
         android:configChanges="orientation|keyboardHidden|screenSize|screenLayout|uiMode"
         android:screenOrientation="portrait" />

     <!-- targetSDKVersion >= 24时才需要添加这个provider。provider的authorities属性的值为${applicationId}.fileprovider，请开发者根据自己的${applicationId}来设置这个值，例如本例中applicationId为"com.qq.e.union.demo"。 -->
     <provider
         android:name="com.qq.e.comm.GDTFileProvider"
         android:authorities="${applicationId}.gdt.fileprovider"
         android:exported="false"
         android:grantUriPermissions="true">
         <meta-data
             android:name="android.support.FILE_PROVIDER_PATHS"
             android:resource="@xml/gdt_file_path" />
     </provider>

     <!-- 如果使用激励视频/全屏视频功能，需要主动在AndroidManifest.xml里面声明MobRewardVideoActivity -->
     <activity
         android:name="com.baidu.mobads.sdk.api.MobRewardVideoActivity"
         android:configChanges="screenSize|orientation|keyboardHidden"
         android:launchMode="singleTask"
         android:theme="@android:style/Theme.Translucent.NoTitleBar" />

     <provider
         android:name="com.baidu.mobads.sdk.api.BdFileProvider"
         android:authorities="${applicationId}.bd.provider"
         android:exported="false"
         android:grantUriPermissions="true">
         <meta-data
             android:name="android.support.FILE_PROVIDER_PATHS"
             android:resource="@xml/bd_file_paths" />
     </provider>

     <provider
         android:name="com.bytedance.sdk.openadsdk.TTFileProvider"
         android:authorities="${applicationId}.TTFileProvider"
         android:exported="false"
         android:grantUriPermissions="true">
         <meta-data
             android:name="android.support.FILE_PROVIDER_PATHS"
             android:resource="@xml/tt_file_paths" />
     </provider>

     <provider
         android:name="com.bytedance.sdk.openadsdk.multipro.TTMultiProvider"
         android:authorities="${applicationId}.TTMultiProvider"
         android:exported="false" />
 </application>

目录结构：

将代码依次复制到自己的项目当中，并在AppConfig类中配置自己的参数

添加依赖

gradle文件依赖部分：

  implementation fileTree(dir: 'arrs', include: ['*.aar'])
  implementation 'com.qq.e.union:union:4.570.1440'
  implementation 'androidx.legacy:legacy-support-v4:1.0.0'
  implementation 'androidx.recyclerview:recyclerview:1.0.0'
  implementation "com.google.android.material:material:1.0.0"
  implementation 'androidx.cardview:cardview:1.0.0'
  implementation 'androidx.appcompat:appcompat:1.0.0'
  implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
  implementation 'com.tencent.bugly:crashreport:latest.release'
  debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.6.1'
  releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.1'
  implementation 'androidx.multidex:multidex:2.0.0'
  implementation 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:+'

在app目录下添加arrs文件夹，把聚合平台的包放进去即可

配置优量汇广告

1. 初始化 SDK

在 Cocos 项目的主脚本中，初始化优量汇 SDK：

// JavaScript 示例
onAD(sender, str) {
        console.log("显示" + str + "广告");
        if (str == "开屏") {
            if (cc.sys.platform == cc.sys.ANDROID) {
                jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "showSplashAd", "()V");
            }
        } else if (str == "激励") {
            if (cc.sys.platform == cc.sys.ANDROID) {
                jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "showRewardedVideoAd", "()V");
            }
        } else if (str == "插屏") {
            if (cc.sys.platform == cc.sys.ANDROID) {
                jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "showInterstitial", "()V");
            }
        } else if (str == "信息") {
            if (cc.sys.platform == cc.sys.ANDROID) {
                jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "showDrawAd", "()V");
            }
        } else if (str == "横幅") {
            if (cc.sys.platform == cc.sys.ANDROID) {
                jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "showBanner", "()V");
            }
        } else if (str == "关闭信息") {
            if (cc.sys.platform == cc.sys.ANDROID) {
                jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "hideDrawAd", "()V");
            }
        } else if (str == "关闭横幅") {
            if (cc.sys.platform == cc.sys.ANDROID) {
                jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "hideBanner", "()V");
            }
        }
    }

在你需要的地方直接调取就可以实现弹出广告了，以上就是cocos脚本在需要的地方调用方法就可以实现安卓平台的广告调用。

git同时提交到github和gitee（双平台同步）

Tue, 02 Jul 2024 10:35:22 GMT

Git 同时提交到 Gitee 和 GitHub

前提条件

你已经在本地初始化了 Git 仓库。
你已经安装了 Git 并配置了用户名和邮箱。
你已经有了一个仓库，你想要进行仓库的同步。

配置远程仓库

添加远程仓库

首先，你需要将 Gitee 和 GitHub 的远程仓库添加到你的本地仓库中。

初始化仓库：你需要在一个空文件夹下进行git仓库的本地初始化。请使用：
```
git init
```
添加远程仓库：
- 添加 Gitee 远程仓库：
```
git remote add gitee https://gitee.com/username/your-repository.git
```
- 添加 GitHub 远程仓库：
```
git remote add github https://github.com/username/your-repository.git
```
  这里的Github也是你实际的仓库地址。需要注意git remote add github 以及 gitee 都被称为别名，那是你在本地的一种命名，实际是只想你后面的地址,所以不必担心这里的命名规不规范，任意就可以。
验证远程仓库：
```
git remote -v
```
输出应显示你刚才添加的两个远程仓库的 URL。

提交到远程仓库

1. 添加和提交更改

git remote add .

添加文件到本地仓库，此时用的是点，代表提交所有的文件，平时也可以使用，因为此提交只会修改与合并。

git commit -m "commit"

commit是你要提交的备注，这个是可以任意的

2. 观察本地仓库的分支

如上图，此时你本地的分支是master分支，这非常重要！在本地进行代码更改后，你需要将这些更改添加到 Git 索引中并进行提交。

3. 推送到仓库

查看你远程仓库的分支名称： Github Gitee

如上面两个图，此时你的github的分支与gitee的分支名称是不一致的，不一致的情况也没有关系，如果一致则可以直接推送，这里不再赘述。

推送到github

git push github master:main

推送到gitee

git push gitee master:master

或者

git push github

由于gitee的分支和我们本地的分支名称一致，所以可以忽略推送分支的名称设置。推送到github由于分支名称与本地不一致，所以需要指定推送的分支：master：main 前面的指定本地的分支，后面指代的远程仓库的分支。

4. 设置变量名称推送到仓库

以上的推送方式是一个一个推送的方式，比较适合管理分支，如开发场景和生产场景的情况，倘若不想使用上述场景，只想一键推送，可以设置变量的形式执行命令。

1. 进入.git文件并打开config文件

2. 设置全局变量名称

 [alias]
  pushall = "!git push gitee master && git push github master:main"

此时只需要执行就可以实现同时推送的功能

git pushall

后记：windows打开隐藏文件夹

$ git push github --delete master

仓库名称分支名称 => 删除某一个分支（远程分支）

删除提交commit 但保留更改

git reset --soft HEAD~1

删除提交commit 并不保留更改

git reset --hard HEAD~1

删除最近的 3 个提交：保留更改

git reset --soft HEAD~3

设置默认分支:

git branch --set-upstream-to=github/main master

master指的是本地分支单独拉取分支：

git pull github main

HostDare CN2-GIA虚假宣传维权记录：一个技术人的较真之路

Sat, 24 May 2025 10:59:00 GMT

前言

作为一名技术人员，我最近的项目需要扩展国际业务寻找合适的服务器分发节点。经过多方比较，我选择了HostDare的”CN2-GIA NVMe KVM VPS”服务，期望通过优质的CN2线路来保障中美之间的网络质量。

然而，这次购买经历让我深刻体会到了什么叫”理想很丰满，现实很骨感”。更重要的是，我决定用技术手段和法律武器，为自己和其他消费者讨个说法。

详细沟通过程

业务需求背景

项目需求

我的项目正在开展国际业务，需要在全球多个节点部署服务器来实现：

API服务的就近访问
内容分发网络(CDN)
数据同步和备份
跨境网络加速

技术要求

对于中美之间的网络节点，我们的核心要求是：

低延迟：RTT < 150ms
高稳定性：丢包率 < 1%
充足带宽：sustained 100Mbps+
抗干扰能力：晚高峰期间性能不能严重下降

为什么选择CN2-GIA

在调研过程中，我了解到：

CN2-GIA：中国电信的顶级国际网络，去程回程都走59.43.x.x优质骨干网
CN2-GT：混合路由，部分优化，价格较低
普通163：传统国际线路，晚高峰严重拥堵

基于业务的高要求，我们决定投资CN2-GIA级别的服务器。

HostDare购买经历

产品选择

经过对比，我选择了HostDare的CSSD0套餐：

产品名称：CN2-GIA NVMe KVM VPS USA
配置：1 vCPU Core, 768MB RAM, 10GB NVMe SSD
网络：250GB月流量，30Mbps CN2 GIA线路
价格：$35.99 USD/年
位置：洛杉矶数据中心

性能测试与问题发现

初步测试结果

服务器部署完成后，我立即进行了网络性能测试：

# x-ui面板速度测试
测试结果：约30Mbps


# 基础延迟测试
ping 114.114.114.114
平均延迟：180-200ms


# 晚高峰测试
晚上8-11点：严重卡顿，代理基本不可用

问题分析

这个结果让我很困惑：

速度偏低：30Mbps远低于真正CN2-GIA应有的性能
延迟偏高：180-200ms超出了CN2-GIA的标准范围
晚高峰拥堵：这是典型的163线路特征

路由追踪测试

# 去程路由测试
root@root:~# traceroute 114.114.114.114
traceroute to 114.114.114.114 (114.114.114.114), 30 hops max, 60 byte packets
 1  193.22.152.1 (193.22.152.1)  0.560 ms  0.643 ms  0.735 ms
 2  172.16.0.1 (172.16.0.1)  0.502 ms 
 3  * **
 4  * ce-2-3-1.a04.lsanca07.us.bb.gin.ntt.net (128.241.2.173)  0.654 ms *
 5  be3360.ccr42.lax01.atlas.cogentco.com (154.54.25.149)  1.387 ms 
 6  * be5992.ccr82.sjc13.atlas.cogentco.com (154.54.169.1)  11.072 ms  10.367 ms
 7  mx97-237.oafishthroat.com (23.236.97.237)  6.881 ms * be6009.ccr41.sjc03.atlas.cogentco.com (154.54.169.38)  10.617 ms
 8  38.104.138.106 (38.104.138.106)  18.862 ms  18.897 ms  19.677 ms
 9  ae-1.zenlayer-c3-networks.sngpsi07.sg.bb.gin.ntt.net (116.51.26.90)  197.796 ms 202.97.6.1 (202.97.6.1)  141.232 ms ae-1.zenlayer-c3-networks.sngpsi07.sg.bb.gin.ntt.net (116.51.26.90)  199.889 ms
10  98.98.126.243 (98.98.126.243)  200.827 ms 98.98.126.245 (98.98.126.245)  182.115 ms *
11  * **
12  202.97.72.94 (202.97.72.94)  141.466 ms 
13  * 202.102.73.14 (202.102.73.14)  164.746 ms 202.102.69.98 (202.102.69.98)  151.943 ms

AS信息查询

root@root:~# curl ipinfo.io
{
  "ip": "2.59.151.75",
  "city": "Los Angeles",
  "region": "California",
  "country": "US",
  "loc": "34.0559,-118.2666",
  "org": "AS40065 CNSERVERS LLC",
  "postal": "90017",
  "timezone": "America/Los_Angeles"
}

回程路由验证

使用第三方工具(tools.ipip.net)测试回程路由，结果显示：

全程走202.97.x.x网段（163骨干网）
AS4134（中国电信163）而非AS4809（CN2）
延迟180-220ms，明显超标

技术结论

这根本不是CN2-GIA线路！

证据确凿：

❌ 去程走NTT→Cogent→163，没有CN2标识
❌ 回程全程202.97.x.x，典型163线路
❌ AS40065 CNSERVERS LLC，不是中国电信
❌ 无任何59.43.x.x网段出现
❌ 晚高峰严重拥堵，符合163特征

客服沟通：官方承认虚假宣传

初次投诉

我向HostDare客服详细说明了技术测试结果，要求解释为什么实际线路与广告不符。

客服回复（原文）

“Currently, we provide one-way GIA as otherwise DDoS attacks make the network unstable. We only optimize to home ISP users in China. From your VPS to your home ISP network IP, it is GIA uplink. From your home ISP to your VPS, it is non-GIA uplink like GTT etc. Also note that we do not optimize uplinks to servers in China. So if you test from a testing website such as ipip.net which uses servers network, it will show non-GIA uplinks.”

回复分析

这个回复实际上是自我定罪的证据：

承认只提供”单向GIA” - 这不是真正的CN2-GIA
承认回程”非GIA上行链路如GTT” - 证明回程走普通线路
承认有显著限制 - 但网站广告从未提及

问题核心：

广告宣传：CN2-GIA（暗示双向优化）
实际提供：单向部分优化（等同于CN2-GT）
价格收费：按CN2-GIA标准收费
实际体验：163线路水平

这就是典型的虚假宣传！

维权策略制定

作为一名理性的技术人员，我决定通过合法途径维护自己的权益，并为其他消费者发声。

维权目标

获得全额退款 $35.99
曝光虚假宣传 警示其他用户
推动行业规范 促进诚信经营

证据收集

我系统性地收集了以下证据：

✅ 产品页面截图（CN2-GIA宣传）
✅ 客服邮件往来（承认服务不符）
✅ 技术测试结果（路由、AS、性能）
✅ 支付凭证（支付宝交易记录）
✅ 第三方验证（多个测试平台）

维权行动实施方案（国际业务的服务商最害怕支付系统被冻结，一般第一步就可以解决）

第一阶段：友好协商

发送正式投诉邮件，详细说明问题并要求退款：

邮件要点：

明确指出虚假宣传事实
提供技术证据支撑
给出合理解决方案
设定回复时间期限

第二阶段：官方投诉

如果协商无效，将启动以下官方投诉：

国内渠道：

12315消费者投诉平台 - 权威性最强
12377网络举报中心 - 针对虚假广告
支付宝交易争议 - 商品与描述不符
地方消协投诉 - 本地消费者保护

国际渠道：

FTC举报 - 美国联邦贸易委员会
BBB投诉 - 美国商业改进局
ICANN投诉 - 针对域名相关欺诈

第三阶段：公开曝光

通过合法渠道进行公开曝光：

技术社区：

WebHostingTalk (WHT) 论坛
HostLoc 中文主机论坛
Reddit r/webhosting 版块
V2EX 技术讨论区

评价平台：

Google Reviews
Trustpilot
Yelp Business

自媒体平台：

技术博客详细分析
YouTube 视频教程
知乎专栏文章

第四阶段：法律行动

如果前三阶段无效，考虑法律途径：

小额诉讼 - 针对$35.99金额
集体诉讼调查 - 联合其他受害者
国际仲裁 - WIPO等机构

最后通牒

基于以上准备，我向HostDare发送了最后通牒：

“Dear HostDare Management,

This is my FINAL ULTIMATUM regarding the false advertising of your CN2-GIA service.

SUMMARY OF FACTS:

I purchased “CN2-GIA NVMe KVM VPS USA” for $35.99 USD
Your product page clearly advertised “CN2-GIA” premium network routing
Your technical team admitted via email that you only provide “one-way GIA” and “non-GIA uplink like GTT”
This constitutes false advertising - you charged CN2-GIA prices for a CN2-GT level service

YOUR WRITTEN ADMISSION: Your email stated: “we provide one-way GIA” and “non-GIA uplink like GTT” - this is NOT the CN2-GIA service advertised and purchased.

TECHNICAL EVIDENCE:

AS40065 CNSERVERS instead of AS4809 China Telecom CN2
Return routing via 202.97.x.x (163 backbone) instead of 59.43.x.x (CN2)
Performance significantly below CN2-GIA standards
Third-party traceroute confirms non-CN2 routing

FINAL DEMAND: Process a full refund of $35.99 USD within 24 HOURS of this email.

ACTIONS TO BE TAKEN IF NO REFUND:

Immediate Actions (within 48 hours):

Payment Dispute Filed - Alipay transaction dispute for “goods not as described”
Regulatory Complaints - Filed with China’s 12315 Consumer Protection Agency
Internet Fraud Report - Submitted to 12377.cn for false advertising

Public Exposure (within 7 days): 4. WebHostingTalk Forum - Detailed false advertising exposure post 5. HostLoc Forum - Warning post to Chinese VPS community 6. Google Reviews - 1-star review with complete evidence 7. Trustpilot - Detailed negative review with documentation 8. Reddit - Posts in r/webhosting and r/VPS communities 9. YouTube Video - Complete technical analysis and scam exposure

Legal/Regulatory Actions (within 14 days): 10. FTC Complaint - False advertising report to US Federal Trade Commission 11. BBB Complaint - Better Business Bureau formal complaint 12. State AG Report - Consumer fraud report to relevant state attorney general 13. Class Action Investigation - Contact other affected customers for group action

International Arbitration: 14. WIPO Complaint - International commercial dispute resolution 15. Small Claims Court - Filing in appropriate US jurisdiction

YOUR REPUTATION AT STAKE: This false advertising scandal will permanently damage HostDare’s reputation in the hosting community. The evidence is overwhelming and your own admission makes this case unwinnable for you.

COST-BENEFIT ANALYSIS:

Refund cost: $35.99
Reputation damage cost: Potentially hundreds of thousands in lost business
Legal defense cost:Thousands of dollars minimum
Time cost: Months of dealing with complaints and disputes

LAST CHANCE: This is your final opportunity to resolve this matter quietly. After 24 hours, I will proceed with ALL planned actions simultaneously.

REFUND PROCESSING: Reply to this email confirming refund approval within 24 hours. Any delays or excuses will trigger immediate escalation.

EVIDENCE PACKAGE: I have compiled a complete evidence package including:

Original product advertisements
Your email admissions
Technical test results
Payment receipts
All communications

This evidence package will be shared with all regulatory bodies, review platforms, and legal entities.

NO FURTHER NEGOTIATIONS: I am not interested in:

Technical explanations
Service credits
Account upgrades
Partial refunds

Only a FULL $35.99 refund is acceptable.

Failure to respond or refund will result in immediate implementation of all threatened actions.

Your move, HostDare.

Best regards, Ane Koby Account: anekoby95@gmail.com Order: CSSD0 - $35.99 USD Server IP: 2.59.151.75

NOTICE:This email and all related communications are being recorded and will be used as evidence in any legal or regulatory proceedings.”

在这样的施压下我们很快就得到了回复，并收到退款，这也很容易理解，毕竟国际业务，最重要的就是收款，国际业务提供商也不想因为这样的原因导致风控，从而失去更多用户。

核心内容

24小时期限 退款最后机会
14项具体行动 详细的后续措施
成本效益分析 让对方权衡利弊
证据包威胁 完整的法律证据链

技术人的思考

为什么要较真？

很多人可能觉得为了$35.99这么折腾不值得，但我认为：

原则问题 - 虚假宣传必须受到惩罚
行业净化 - 推动诚信经营风气
技术责任 - 用专业知识保护消费者
成本考虑 - 时间成本vs社会价值

技术验证的重要性

普通用户可能只是感觉”网络慢”，但技术人员可以：

通过路由追踪发现问题根源
用AS信息验证网络归属
对比技术标准识别虚假宣传
提供无可辩驳的技术证据

维权策略的技术思维

系统性收集证据 - 如同debug程序
多路径并行执行 - 分布式维权策略
持续监控反馈 - 根据响应调整策略
文档化整个过程 - 便于复现和分享

给其他技术人的建议

购买VPS前的技术验证

查看真实用户评测 - 不要只看官方宣传
要求试用或退款保证 - 技术产品需要实测
了解网络基础知识 - 区分CN2-GIA/GT/163
使用第三方测试工具 - 验证商家宣传

遇到问题时的处理原则

技术证据先行 - 用数据说话
保存所有证据 - 邮件、截图、日志
理性分析成本 - 时间vs收益
坚持合法维权 - 不要情绪化

行业呼吁

对VPS商家的建议

诚实宣传 - 如实描述技术指标
透明定价 - 清楚说明服务级别差异
技术支持 - 能够解答专业问题
退款保证 - 对技术产品提供试用期

对监管部门的建议

制定技术标准 - 明确CN2等概念定义
加强跨境监管 - 海外商家的广告审查
支持技术维权 - 重视专业人士的举报
行业规范化 - 推动诚信经营体系

结语

作为技术人员，我们有责任用专业知识来维护行业的健康发展。虚假宣传不仅损害了消费者利益，也破坏了整个行业的信任基础。

这次维权行动不仅仅是为了$35.99，更是为了：

让技术诚信成为行业标准
保护其他消费者免受欺骗
推动VPS行业的规范发展

我会持续更新这个维权过程，希望能为遇到类似问题的朋友提供参考。同时，也欢迎其他技术人员分享自己的经历，让我们一起净化这个行业。

写到最后

最后也是成功追回

技术改变世界，诚信铸就未来。

声明：本文所有内容基于真实经历，技术数据真实有效。文章仅代表个人观点，不构成法律建议。如需专业法律意见，请咨询执业律师。

🚀 内网项目踩坑实录：从 HTTP 到 HTTPS 的血泪史

Thu, 03 Jul 2025 16:35:00 GMT

📋 TL;DR（Too Long; Didn’t Read）-概述

问题: 微信公众号爬虫在内网部署时无法登录
原因: HTTP 环境下无法设置 Secure Cookie + Deno KV 生产环境依赖
解决: 部署自签名 HTTPS + 删除用户存储功能
结果: 功能完美运行 ✨

🎯 项目背景

需求简述

开发一个微信公众号文章爬虫工具，供公司内部使用。由于数据安全要求，必须部署在内网环境。

技术栈

Framework: Nuxt.js 3
Runtime: Node.js
Proxy: Nginx
Panel: 宝塔面板
Environment: Ubuntu 22.04 + 内网 172.19.23.27

预期 vs 现实

环境	预期	现实
公网测试	✅ 完美运行	✅ 确实完美
内网部署	🤔 应该没问题吧	💥 完全不能用

🔥 问题一：Cookie 安全策略地狱

💀 症状描述

部署到内网后，用户扫码登录时：

二维码可以显示 ✅
扫码成功 ✅
点击登录… 毫无反应 ❌

宝塔配置如下：

通过反向代理打到本地3000端口，实现内网访问

🔍 错误现场

打开 F12，没有任何报错，甚至无法定位问题，此时的我非常焦虑，无论是多级反向代理还是跨域配置我都尝试了，并且长达两个小时都无法解决，此时我在本机ubantu的firefox才看到具体的报错信息，如图所示：

这真的让我非常难顶！！！排查了这么久，firefox直接就帮我定位了问题。（：

🚫 Cookie "slave_user" has been rejected because a non-HTTPS cookie can't be set as "secure"
🚫 Cookie "master_sid" has been rejected because a non-HTTPS cookie can't be set as "secure"  
🚫 Cookie "bizuin" has been rejected because a non-HTTPS cookie can't be set as "secure"
🚫 Cookie "data_ticket" has been rejected because a non-HTTPS cookie can't be set as "secure"
... (重复 N 遍)

💡 第一反应: 这什么鬼？为什么公网好好的，内网就不行？

🕵️ 深入调查

问题根源

微信公众平台返回的 Cookie 长这样：

Set-Cookie: slave_user=xxx; Path=/; Secure; SameSite=None; HttpOnly
Set-Cookie: master_sid=yyy; Path=/; Secure; SameSite=None; HttpOnly

关键在于 Secure 标志！

浏览器安全策略

if (cookie.hasSecureFlag && location.protocol !== 'https:') {
  console.error('🚫 Cookie rejected: non-HTTPS environment')
  return false
}

环境对比

环境	协议	Cookie 设置	结果
公网	`https://`	✅ 允许 Secure Cookie	🎉 登录成功
内网	`http://`	❌ 拒绝 Secure Cookie	💥 登录失败

💡 解决思路

既然浏览器严格要求 HTTPS 才能设置 Secure Cookie，而微信登录又必须依赖这些 Cookie，那只有一个办法：

给内网环境配置 HTTPS！

🛠️ HTTPS 部署实战

Step 1: 生成自签名证书

# 一键生成支持多地址的证书
openssl req -x509 -newkey rsa:2048 \
    -keyout server.key -out server.pem \
    -days 365 -nodes \
    -config <(
    echo '[dn]'
    echo CN=172.19.23.27
    echo '[req]'
    echo distinguished_name = dn
    echo '[EXT]'
    echo subjectAltName=@alt_names
    echo '[alt_names]'
    echo DNS.1=localhost
    echo DNS.2=wechatccc.com
    echo IP.1=172.19.23.27
    ) -extensions EXT

Step 2: 宝塔面板配置

网站设置 → SSL 选项
选择”其他证书”
将 server.pem 内容粘贴到”证书(PEM格式)”
将 server.key 内容粘贴到”密钥(KEY)”
保存并启用 HTTPS

Step 3: Nginx 配置

宝塔会自动生成配置，核心部分：

server {
    listen 80;
    listen 443 ssl http2;
    server_name 172.19.23.27 wechatccc.com;

    # 🔒 SSL 证书配置
    ssl_certificate /www/server/panel/vhost/cert/domain/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/domain/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    # 🔄 反向代理到 Nuxt 应用
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $http_host;
        proxy_set_header X-Forwarded-Proto $scheme;
        # ... 其他标准代理配置
    }
}

🎯 问题一解决

访问 https://172.19.23.27：

⚠️ 浏览器显示”不安全”警告（自签名证书）
✅ 点击”高级” → “继续访问”
✅ Cookie 设置成功，登录流程恢复正常

🔥 问题二：Deno KV 生产环境炸弹

💣 新的爆炸

刚解决 Cookie 问题，结果点击登录后又炸了：

{
  "statusCode": 500,
  "message": "Could not find a Deno KV for production, make sure to deploy on Deno Deploy."
}

🤔 心理活动: 什么？我明明用的是 Node.js，怎么扯到 Deno 了？

🔍 代码考古

发现用户存储模块有这样的逻辑：

export async function createUser(user: UserEntry): Promise<boolean> {
    if (process.dev) {  // 🟢 开发环境：直接跳过
        return Promise.resolve(true)
    }

    // 🔴 生产环境：尝试连接 Deno KV
    const kv = await useKv()  // 💥 爆炸点
    // ... 复杂的用户存储逻辑
}

📊 环境差异分析

环境类型	NODE_ENV	process.dev	执行路径	结果
开发环境	`development`	`true`	跳过 KV	✅ 正常
生产环境	`production`	`false`	连接 KV	💥 报错

原来如此！ 开发环境下代码会跳过用户存储，所以没问题。但生产环境会尝试连接 Deno KV 数据库，而我的部署环境是 Node.js，当然找不到！

🤔 功能必要性评估

仔细思考用户存储功能：

作用: 用户信息持久化、多账号管理、登录状态保持
对爬虫的必要性: 🤷‍♂️ 不是核心功能
复杂度: 🔴 增加部署复杂性

决策: 直接删除用户存储功能，专注核心爬虫能力！

💡 简单粗暴的解决方案

直接让所有用户存储函数返回成功/空值：

export async function createUser(user: UserEntry): Promise<boolean> {
    // 🚀 直接返回成功，不存储任何用户信息
    console.log(`📝 跳过用户创建: ${user.nickname}`)
    return Promise.resolve(true)
}

export async function getUser(originalID: string): Promise<UserEntry | null> {
    // 🚀 直接返回 null，表示"新用户"
    return null
}

export async function getUserByUUID(uuid: string): Promise<UserEntry | null> {
    return null
}

export async function getUserByFakeID(fakeid: string): Promise<UserEntry | null> {
    return null
}

🎉 最终效果

✅ 功能验证

# 🔗 HTTPS 访问
curl -I https://172.19.23.27
# HTTP/2 200 ✅

# 🍪 Cookie 设置
# F12 → Application → Cookies → 看到完整的微信认证 Cookie ✅

# 🔐 登录流程
# 扫码 → 点击登录 → 跳转成功 ✅

# 🕷️ 爬虫功能
# 数据爬取完全正常 ✅

📈 性能表现

响应时间: 200-500ms
稳定性: 24h 无异常
资源占用: 
  CPU: < 5%
  Memory: < 200MB
用户体验: 🌟🌟🌟🌟🌟

🎓 经验总结

💎 核心洞察

1. 安全策略进化论

现代浏览器对 Cookie 安全要求越来越严格：

Secure 标志强制要求 HTTPS
SameSite=None 必须配合 HTTPS 使用
即使内网环境也无法例外

2. 环境一致性的重要性

- 开发环境: HTTP + 跳过复杂逻辑
+ 生产环境: HTTPS + 完整功能实现
= 隐藏问题，部署时爆炸 💥

3. Keep It Simple, Stupid!

当遇到复杂的依赖问题时，问问自己：

这个功能真的必要吗？
能不能用更简单的方式解决？
核心业务需求是什么？

🛡️ 避坑指南

✅ 优先检查浏览器控制台 Cookie 错误
✅ 确认协议匹配（HTTP vs HTTPS）
✅ 理解 Secure/SameSite 属性含义

数据库依赖管理

✅ 区分开发和生产环境的差异
✅ 评估功能的实际必要性
✅ 优先解决核心问题，再考虑完善功能

内网部署特殊性

✅ 不要以为内网就可以降低安全标准
✅ 自签名证书是内网 HTTPS 的好选择
✅ 简化架构，减少外部依赖

🚀 总结

这次踩坑经历的核心收获：

🔧 技术层面

HTTPS 不是可选项：即使内网环境，现代 Web 应用也需要 HTTPS
自签名证书很实用：快速、简单、满足功能需求
功能删减有时比优化更有效：不必要的复杂性就是技术债务

🎯 工程思维

问题导向：专注解决实际问题，而不是实现所有功能
渐进式开发：先让核心功能工作，再考虑完善
简化优于复杂：能删就删，能简化就简化

💡 部署经验

环境一致性很重要：开发和生产环境的差异会隐藏问题
错误信息是最好的老师：仔细阅读错误信息，往往直接指向解决方案
内网不等于简单：现代 Web 标准不会因为内网而降低要求

🎬 结语

从 HTTP 到 HTTPS，从复杂的用户管理到简化的核心功能，这次部署经历让我深刻理解了：

🌟 工程不是艺术，而是在约束条件下找到最优解的过程。

有时候，删除代码比写代码更有价值。有时候，简单粗暴的方案比精巧复杂的设计更实用。

技术服务于业务，而不是相反。

投资思考与育儿智慧：透过现象看本质

Fri, 30 May 2025 10:46:00 GMT

文章摘要

这是一篇融合了股市分析、政治解读和育儿哲学的深度思考文章。作者从标普500和纳指的技术分析开始，延伸到对特朗普关税政策的法理解读，最后分享了关于育儿和人生的深刻思考。文章体现了作者”透过现象看本质”的思维方式，强调了解规则、理性分析的重要性。

核心观点

投资理念

市场永远是对的，抱着自己的对错进市场的人都活不下来
英伟达遇到143-145阻力位后回落，需要大利好才能突破
生物医药板块联合健康在300左右震荡筑底

政治分析

特朗普关税被法院叫停，但可通过《国家紧急状态法》继续执行
马斯克退出政府效率部是因为法律限制，作为”特殊政府雇员”只能工作130天
美国三权分立制度的运作机制与中国不同

育儿智慧

“鸡娃不如鸡自己” - 卷自己比卷孩子效果更好
最好的学区房是家庭，父母是原件，孩子是复印件
成年人最好的学区房是病房 - 健康比什么都重要

人生感悟

小孩子的快乐很简单，要让他们有快乐的童年
《西游记》中孙悟空的智慧：懂得维系关系，理解规则
做投资的人杠精少，因为市场会教育所有人

原文内容

” 标题: 成为另外一种人~ 标普500和纳指分别微涨0.4%、0.39%，高开回落。

标普500的上方阻力位是6000点，纳指是20000点，这两个阻力位是多空双方争夺的密集区。

持仓的个股中，生物医药板块全部微涨，消费股大部分微跌，伯克希尔和VISA微涨，科技股板块大多微涨。

生物医药板块的联合健康短期内会在300左右震荡一段时间，筑底后再往上修复，最糟糕的阶段开始慢慢过去了。

英伟达和预期的一致，在遇到143-145这个阻力位后回落，最终收盘价139.19美元，涨幅3.25%；后续要突破143-145这个阻力位，需要有大的利好，突破后则奔着153这个阻力位去了。

没啥可以操作的，接下去的时间，以等待为主。

川普的关税被联邦外贸法院叫停，关税战上半场进入休息时间，下半场再过段时间开始。

法院的结果一出来，5分钟内川普政府立马提起上诉。

老美是三权分立体系，按照宪法规定，征税权属于国会。

但1976年颁布的《国家紧急状态法》，国家处于紧急状态时，总统有权力发布和采取尽力措施，其中包含临时征收税款和改动税率。

国家是否处于紧急状态，只能由总统负责认定，法院无权干预总统的决定。即司法可以制衡行政，但不能代替行政。

也就是说，总统有权单方面认定紧急状态是否成立，不需要为是否真的处于紧急状态这件事提供证据和证明。

老美历任总统行使紧急状态的次数都很多，最近几个总统中，川普目前是行使次数最少的，4次，分别是:加强边境管理、2018年中美贸易战、应对新冠疫情，以及本次贸易战。

作为对此，拜登行使9次，奥巴马12次，小布什13次，克林顿17次。

后续川普只要以“美国财政即将破产”这一理由，就能行使紧急状态，将关税战继续打下去，并且不需要证明美国的财政是否真的即将破产。

另外，即便最高法院以防卫措施过大、范围过大等为由，裁定川普的关税战违法，联邦政府也可以拒绝执行最高法院的裁决。典型案例，是拜登政府“拒绝”执行最高院关于豁免学生贷款的裁决，绕了个弯把豁免贷款的目的实现了。

老美的三权分立是个很有意思的游戏，和咱们很不一样，不要用咱们的套用在老美身上，不适用。

比如马斯克将退出政府效率部这事。

按照老美的法律，去政府任职要避嫌，所以川普把自己的公司股权等商业资产装入到信托，由其他亲属打理。不走完这些程序，是不能去当总统的。

但老美的官分两种:

一种是由总统提名，由参议院确认的那些国防部长、财政部长等官员；另一种是总统根据自己的需要任免，不需要通过国会，类似于“家臣”，白宫幕僚长、总统法律顾问等，都是这一类。

这两种马斯克都做不了，有利益冲突。因此，只能以特殊政府雇员来参与。

根据美国司法部的定义，特殊政府雇员是指在365天内为政府工作不超过130天的临时雇员，通常以专家或顾问身份提供专业支持。

这一身份允许马斯克在不公开披露其财务状况的情况下参与政府工作，同时可以继续管理其商业和公司。

2025年2月3日，白宫官方确认马斯克被任命为“特殊政府雇员”。按照130天的限制，马斯克就是必须得在5月底结束任期的。

嗯，就这么简单，明白了内在规则，就知道事情接下去的走势，不容易被带节奏。

我喜欢跟做投资的人聊天，杠精少。搞钱的永远不会有什么杠精，因为去了市场你就知道，市场永远是对的；抱着自己的对错进市场的人，都活不下来。

那些动不动就爱抬杠的人，往往要么穷，要么是学生或刚入社会的小白。

昨晚睡得早，今天5点50分就醒来。起来洗漱了一番，陪孩子们吃个早饭。

老二老三很开心，因为今天学校看表演，可以带玩具到学校玩。

有时觉得，小孩子的快乐真的很简单。我尽量让他们有个快乐的童年。

卷他们，还不如卷我自己，鸡娃不如鸡自己，自己都卷不出来，还想卷娃，想啥呢；自己卷出来了，说明卷自己效果更好，那就更没必要卷娃了。

现在的机会点和窗口期，肯定比他们以后多。还不如我自己努力点，让孩子以后有需要能拼得了爹，而不是看别人拼爹。

当然，前提是他们知道，好爹要用在刀刃上，而不是用在朋友圈里，否则就是把爹的收益最小化，把爹的风险最大化，哈哈。

他们这代人是要去见世界的，要走出属于自己的路，踏上属于自己的人生。

我顶多是他们去见世界的那个物质兜底，至于路怎么走、世界怎么样、从哪个角度看等等，需要他们自己根据自身的能力和见识、认知做判断。

而自身的能力和见识、认知，是他们需要童年、少年、青年期走过一段漫长的路，也就是“学习”。

对于孩子来说，最好的学区房是家庭，父母是原件，孩子是复印件，因此言传身教、以身作则就是最好的榜样。

对于成年人来说，最好的学区房是病房。无论你有多大的野心和控制欲，病房里多躺一躺，就知道人生什么最重要，别期望值太高、控制欲太强，动不动把孩子往死里卷，没必要。

小儿子有段时间不读《西游记》和《三国演义》了，我问他怎么不喜欢了？

他说打打杀杀没意思。

媳妇笑着说小儿子他没看懂，打打杀杀是表面，内在都是人情世故:

你看孙悟空多聪明，知道师傅有后台，但从不让师傅出面，每次遇到麻烦都尽可能不出全力打败妖怪，而是求助于各路神仙。

貌似都是自己在到处欠人情，但其实都是在维系关系，各路神仙因此能在取经过程中捞到一份人情和功劳；而上级都知道是在给谁面子。

要不以孙悟空大闹天宫的本事，怎么可能打不过那些妖怪。

而且，孙悟空无论多难，从不质疑取经事业的正确性，有大觉悟，因此显得特别能干，特别敬业，是真正的打工人楷模。

你看不起“孙悟空”的能力退化、溜须拍马跑关系，“孙悟空”还看不起你榆木脑袋不懂变通、自以为是。

老大打岔，说他懂这个，几年前他问过我一个问题，为什么会有两个司机？

我说一个是职业是司机，专门负责开车的；另一个是职务是司机，挂职的，很多难搞定的关系、难预订的餐厅、难见得了面的人…他都能搞定，只是挂司机的头衔，实质做的是一系列“有核心竞争力”的活。

看起来同样是司机，但只有第二种最吃香，不可替代。

回到《西游记》的话题上，孙悟空很聪明，但唐僧这领导也很聪明。

唐僧作为取经小团队的领导，他的任务根本就不是保证取经成功，因为取经必然成功。唐僧很清楚，保证取经必须按照上级要求的方式成功，才是自己要做的事。

说白了就是只对上面负责，“权力只对权力的来源负责”，这是唐僧聪明的地方。

老二对这些话题明显没兴趣，专注吃她的饭。

时间过得飞快，一眨眼就要送他们去学校了。

自从娃们上学后，每天相处的时间变得越来越少，以后上大学、工作了，能陪伴得就更少了。

媳妇说每次想到这个，就想多生几个孩子，哈哈，我问她年轻时咋没这个觉悟。

她回答，那个时候正值计划生育不允许超生，且那会还不具备生多孩的条件和勇气。

我想了想，也是。

愿我们都拥有随时停留和休息的底气，做人做事越来越平和、平淡。

就这样吧。 ”

精选评论区互动

关于作者夫人的智慧

兵（重庆）：你有时间谈下是怎么娶了个睿智婆娘的吧！

金渐成（作者）：写过的，我二次创业失败时，背负了巨额负债，女朋友也跑了，同事的她不知道我海外有收入，傻乎乎抵押了自己的房子借钱给我，经常陪我聊天散心，我报恩把自己”抵押”给她了，借钱借成老公

天亮（北京）：你这么说就是当初想赖账不还钱

金渐成（作者）：两年后，给了她200多倍的回报，你就说这回报率高不高嘛

关于美国政治制度

凯（加拿大）：机哥你一段话把主流媒体报道马斯克和川普反目的故事给戳破了😃！

金渐成（作者）：现在反智的多，能讲清楚内在规则的少，都是情绪，少有理性。

Friend²⁰²⁵（广东）：还得是老美，法院敢和总统抬杠

金渐成（作者）：这法院，居然没被拆了，大法官居然还能干得好好的，没有丟了饭碗；总统居然奈何不了美联储的行长，哈哈哈，很多事看起来很有趣，挺好玩的，分权制衡是个好东西，避免了权力一家独大。

关于育儿理念

文博（中国香港）：自己卷出来了，说明卷自己效果更好，那就更没必要卷娃了——就是这么干的

金渐成（作者）：嗯，卷娃不划算，卷自己回报率才高。如果自己都卷不动，还卷娃，那就更没意义了，娃基因突变、爆种的概率太低。

🌽ㅤ（广东）：鸡娃就是压力转移大法，家长把自己无能的压力、生活上的压力转移给孩子。

金渐成（作者）：嗯，鸡娃真残忍，就像虐猫虐狗一样。

关于投资心态

Peter Edmund陈（美国）：读书读得越多，看的东西越多，反而变得大多数时候有点沉默，看到自己的无力，对于有些事情我们不能改变，连改变自己的看法都异常困难。

金渐成（作者）：嗯，我也有几年是很纠结、矛盾的状态，后来想通了，怎么都是生活，不需要在意他人的看法和期待，做自己想做的和能做的就行，其他的随他去了。

ᰔᩚ 云汐大人༊（江苏）：市场永远是对的；抱着自己的对错进市场的人，都活不下来。那些动不动就爱抬杠的人，往往要么穷，要么是学生或刚入社会的小白。我很赞同

金渐成（作者）：所以一看网上的信息，就容易知道哪些人是穷人和小白，哪些人是搞投资的。信息很好分辨，搞投资的人往往观点和做法更有说服力，因为都是真金白银砸出来的。

关于健康的重要性

℡.wl（重庆）：前段时间结石急性，那两天唯一的感觉就是，身体健康才是第一，其他都需要排在这个后面，病房去了一遭，想起之前机哥说的身体重要，又深深的感动了

金渐成（作者）：成年人的最好学区房，是病房。这句话我深有体会

关于《西游记》的深度解读

劲松（北京）：每读机哥的育儿经，都学到不少，像孙悟空的见解和我之前看到的完全不同，那个版本说猪八戒讨领导喜欢，孙悟空累死累活打工苦命人。今天看机哥这视角，才发觉孙悟空才是有勇有谋，有情商的那个，要不最终他成佛，猪八戒没成佛呢

PowerVito（北京）：牛魔王就是不明白，坐莲台级别领导的青牛、锦毛吼，跟他那个谁都能骑的傻冤家碧水金睛兽，完全不是一回事儿😂

关于学习和成长

晨（上海）：再次拜服极哥。才意识到白看了那么多遍西游记了…知道猴子聪明，却从来没去思考过背后这么多的真相。果然，不能只读书，读死书啊。怎样灵活变通，汲取知识和教训才有意义。

金渐成（作者）：因为大多数人只有情绪，很容易陷入自嗨。多了解规则，多熟悉底层逻辑，就会有自己的判断。

个人感悟

这篇文章让我深刻体会到了什么叫”透过现象看本质”。在信息爆炸的时代，媒体往往更倾向于制造情绪和话题，而非帮助受众理解事情的内在逻辑。

作者对马斯克退出政府职务的分析就是典型例子。大多数媒体报道都在渲染”反目成仇”的戏剧性，但实际上这只是美国法律制度的正常运作。了解了《特殊政府雇员》的130天限制规定，就能明白这是必然结果，而非什么政治斗争。

在育儿方面，“鸡娃不如鸡自己”这个观点特别有启发性。很多家长把自己的焦虑和压力转移给孩子，美其名曰”为了孩子好”，实际上可能是在逃避自我提升的责任。如果连自己都无法突破，又怎么指望孩子能够超越？

文章中对《西游记》的解读也很精彩。孙悟空的智慧不在于武力，而在于对规则的理解和对关系的维护。这种职场智慧的解读，让经典名著有了新的现实意义。

最深刻的是”成年人最好的学区房是病房”这句话。健康面前，其他一切都是浮云。这提醒我们要时刻保持清醒，不要被外在的成功标准绑架，忘记了生活的本质。

声明：本文内容来源于公众号分享，仅供学习交流使用。投资有风险，决策需谨慎。文中观点仅代表作者个人看法，不构成投资建议。

CentOS 7运维常用的命令

Fri, 30 Aug 2024 11:53:22 GMT

CentOS 常用命令集

本文适合基于CentOS 7且有基础的运维同学，一些常见的命令如“cd、rm”等命令不会列举，仅仅会给出在开发视角中常用的命令。

ps aux          # 显示所有进程
ps -ef          # 显示完整格式的进程信息
uname -a        # 显示所有系统信息
df -h           # 以人类可读格式显示
uptime          # 显示系统运行时间
ifconfig        # 显示网络配置
ps -ef|grep nginx # 显示nginx进程、过滤后。

防火墙

systemctl stop firewalld.service
systemctl start firewalld.service
firewall-cmd --zone=public --add-port=200006/tcp --permanent
firewall-cmd --zone=public --remove-port=200006/tcp --permanent
firewall-cmd --reload
firewall-cmd --list-all

Nginx

sudo systemctl start nginx
sudo systemctl stop nginx
sudo systemctl restart nginx 
nginx -s reload
nginx -s quit
nginx -v

jar包运行

nohup java -jar pakageName.jar &   # 后台运行jar包并输出到nohup日志
java -jar pakageName & # jar包如果有配置日志

现代AI爬虫的进化之路：从OCR到Markdown的完美转身 🚀

Fri, 04 Jul 2025 17:10:00 GMT

前言 💭

最近在搞爬虫项目的时候，发现了一个很有意思的现象：现代爬虫必须要有AI加持才能玩得转！🤖 传统的正则表达式抓取方式已经被AI狠狠地”降维打击”了，效率提升不是一点半点。

但是，理想很丰满，现实很骨感… 😅

现有方案的痛点 😵‍💫

📝 纯文本类型

案例：新闻文章、博客内容
处理难点：相对简单
现有方案问题：基本能处理

🖼️ 图片+文字类型

案例：产品介绍页面、技术文档
处理难点：OCR识别准确率、中文字符识别
现有方案问题：百度OCR经常识别错误，需要人工校验

📊 图片+表格类型

案例：财务报表、数据统计页面
处理难点：表格格式丢失、行列关系混乱
现有方案问题：OCR无法保留表格结构，AI理解困难

多模态大模型的”美丽陷阱”

说到AI爬虫，大家第一反应可能是：“用多模态大模型啊！ChatGPT不香吗？” 🤔

emmm… 香是香，但是有几个问题：

中文理解能力有限 🈹
- 毕竟是国外的大模型，中文训练还是有些欠缺
- OCR识别中文的准确率让人捉急
- 我们项目不允许有错误数据，所以直接pass
API支持不够完善 📡
- 大部分支持API的多模态模型还没完全开放
- 即使有，成本也不低

所以我们选择了国产大模型DeepSeek，至少中文理解能力杠杠的！🎯

数据结构的”混乱现状”

我们项目遇到的数据结构简直是”百花齐放”：

📝 纯文本：这个还好处理
🖼️ 图片+文字：需要OCR配合
📊 图片+文字+表格：这就头大了…

更要命的是，图片里经常混杂着我们需要的信息，但也有很多无用图片，程序很难自动筛选。

当前方案的”冗余困境”

我们现在的流程是这样的：

获取文本和图片 → 图片丢给百度OCR → 拼接完整文章 → 投给DeepSeek提取数据

问题来了：

❌ 流程冗余：步骤太多，效率低
❌ 通用性差：每个网站都要调整
❌ 表格处理弱：OCR无法保留表格格式
❌ 噪音太多：无用图片干扰数据提取

灵感闪现：Markdown才是王道！💡

突然想到一个问题：为什么不直接用Markdown呢？

想想看，Markdown的优势：

✅ 纯文本格式 - 轻量级，易处理
✅ 格式友好 - 保留基本样式和结构
✅ AI友好 - 大部分模型输出都是Markdown
✅ 通用性强 - 一套流程走天下

解决方案：PDF转Markdown的完美方案 🎯

经过一番调研，发现了一个神器：MinerU！

核心思路

网页 → PDF/图片 → Markdown → AI提取数据

为什么选择MinerU？

🔍 项目地址：https://github.com/opendatalab/MinerU/tree/master

优势清单：

🇨🇳 中文友好：识别中文准确率极高
📐 排版自然：保留原有格式和结构
📊 表格支持：完美处理表格数据
🎯 精准识别：汉字识别准确度很高
🔄 数据完整：不丢失关键信息

实际效果

使用MinerU转换后的Markdown数据投给AI：

✅ 数据完整性 - 不丢失任何关键信息
✅ 格式保持 - 表格、列表等结构完整
✅ 噪音减少 - 无用图片被过滤
✅ 处理效率 - 一步到位，省心省力

总结 🎊

从传统的正则表达式，到OCR+AI的组合拳，再到现在的PDF转Markdown方案，AI爬虫的进化之路充满了惊喜！

核心观点：

🤖 AI加持是必然趋势 - 告别正则表达式时代
🎯 选择合适的模型 - 根据业务需求选择中文友好的模型
📄 Markdown是最佳载体 - AI友好且保留格式
🔧 工具选择很重要 - MinerU这样的工具能事半功倍

现在的方案不仅解决了数据混乱的问题，还大大提升了提取精度和效率。如果你也在做类似的项目，强烈推荐试试这个方案！🚀

怎么样，这波操作是不是很6？ 😎

🔥 服务器突然挂了？我被攻击了？一次惊心动魄的故障排查经历

Sat, 05 Jul 2025 20:26:00 GMT

🚨 突如其来的灾难

我服务器上一直有一个服务在跑，但是突然发现我的一个重要网络服务怎么都连不上了 😱

症状如下：

🔴 客户端连接超时
🔴 延迟显示 -1
🔴 各种重试都无效

第一反应：🤯 “完了，服务器是不是被黑了？”

🆘 紧急抢救

既然连不上，那就先重启试试吧（程序员的万能解决方案 😅）

随后我到服务器提供商面板去重启

神奇的事情发生了 ✨ —— 重启后服务立即恢复正常！

但是问题来了：为什么重启就好了？根本原因是什么？

作为一个有追求的技术人，怎么能就这样算了呢？必须要找出真相！🕵️‍♂️

🔍 开始福尔摩斯时间

第一条线索：可疑的登录记录

登录服务器后，发现了第一个异常：

Last failed login: Sat Jul  5 07:54:21 EDT 2025 from 152.200.181.42 on ssh:notty
There were 40 failed login attempts since the last successful login.

😳 40次失败登录？ 这绝对不正常！

第二条线索：系统错误日志

继续深挖，查看系统日志：

journalctl --since "2025-07-05 06:00:00" --until "2025-07-05 07:13:00" -p err

发现了这些可疑的错误：

Jul 05 06:08:13 sshd: error: kex_exchange_identification: Connection closed
Jul 05 06:10:31 sshd: error: kex_exchange_identification: Connection closed  
Jul 05 06:46:52 sshd: fatal: userauth_finish: send failure packet: Connection

🤔 SSH连接错误？感觉离真相越来越近了…

第三条线索：暴力破解攻击！并且ip来自于德国、香港等地

当我查看详细的登录失败记录时，真相大白了！

journalctl | grep "Failed password" | tail -20

映入眼帘的是一连串触目惊心的攻击记录：

Jul 05 07:41:44 Failed password for root from 80.94.95.15
Jul 05 07:42:26 Failed password for root from 123.58.209.224  
Jul 05 07:42:45 Failed password for invalid user odoo15 from 161.35.72.143
Jul 05 07:43:02 Failed password for root from 103.63.25.239
Jul 05 07:47:41 Failed password for root from 152.200.181.42
...

🚨 天哪！我的服务器正在遭受大规模的SSH暴力破解攻击！

🧩 真相大白

现在一切都说得通了！

攻击的影响链条：

🏴‍☠️ 多个IP同时发起SSH暴力破解
- 每隔几秒就有新的攻击尝试
- 来自世界各地的僵尸网络
⚡ 系统资源被疯狂消耗
- 每个SSH连接尝试都要消耗CPU和内存
- 网络连接池被占满
- 文件描述符被耗尽
💥 其他服务受到牵连
- 我的网络服务无法获得足够资源
- 新连接被拒绝
- 表现为”服务挂了”
🔄 重启为什么能解决？
- 清除了所有攻击连接
- 释放了被占用的系统资源
- 服务重新获得正常运行环境

原来我的服务没坏，是被攻击”挤”挂了！ 😂

🛡️ 绝地反击：防御策略

既然找到了根本原因，那就要彻底解决这个问题！我们遇到这种攻击可以有多种方案，譬如修改端口，设置防火墙等

🚀 终极武器：fail2ban

经过研究，我选择了 fail2ban 这个神器：

# 安装fail2ban
yum install epel-release -y
yum install fail2ban -y

# 配置严格的防护策略
cat > /etc/fail2ban/jail.local << 'EOF'
[DEFAULT]
# 封禁24小时，让攻击者冷静冷静
bantime = 86400
# 监控10分钟内的行为
findtime = 600
# 最多容忍3次失败
maxretry = 3

[sshd]
enabled = true
port = ssh
filter = sshd
logpath = /var/log/secure
# SSH更严格：2次失败就封禁
maxretry = 3  
# SSH攻击者封禁7天
bantime = 604800
EOF

# 启动防护
systemctl enable fail2ban
systemctl start fail2ban

📊 效果验证

配置完成后，可以通过以下命令查看防护效果：

# 查看防护状态
fail2ban-client status sshd

# 查看被封的攻击者
fail2ban-client get sshd banned

# 实时监控攻击
tail -f /var/log/fail2ban.log

看着攻击者的IP一个个被加入黑名单，那感觉简直太爽了！ 😎

💡 经验总结

这次故障排查让我学到了很多：

🎯 关键收获

🔍 日志是最好的朋友
- 系统日志包含了所有的线索
- 学会读懂各种日志格式
- 时间线分析很重要
🌐 网络安全不容忽视
- SSH暴力破解攻击无处不在
- 即使不直接攻击目标服务，也可能造成间接影响
- 防护措施要尽早部署
⚡ 资源耗尽的隐蔽性
- 问题表现可能与根本原因相距甚远
- 系统资源竞争会导致意想不到的故障
- 重启能解决很多问题，但不能只满足于此

🛠️ 实用建议

🚨 立即行动: 如果你的服务器还没有部署 fail2ban，赶紧去配置！
📈 监控重要: 定期检查系统日志，及早发现异常
🔐 安全意识: 修改默认SSH端口、禁用root登录等都是好习惯

🎉 结语

虽然这次”故障”让我紧张了一阵子，但最终的排查过程还是很有成就感的 💪

从表面现象到深层原因，再到最终解决方案，整个过程就像解谜游戏一样有趣。

最重要的是：遇到问题不要慌，日志会告诉你一切！ 📚